@cogitator-ai/bridge 0.4.0 → 0.6.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 (100) hide show
  1. package/README.md +87 -35
  2. package/dist/adapter.d.ts +34 -2
  3. package/dist/adapter.d.ts.map +1 -1
  4. package/dist/adapters/claude.d.ts +95 -2
  5. package/dist/adapters/claude.d.ts.map +1 -1
  6. package/dist/adapters/claude.js +207 -3
  7. package/dist/adapters/claude.js.map +1 -1
  8. package/dist/adapters/hosted.d.ts +38 -5
  9. package/dist/adapters/hosted.d.ts.map +1 -1
  10. package/dist/adapters/hosted.js +190 -10
  11. package/dist/adapters/hosted.js.map +1 -1
  12. package/dist/client.d.ts +26 -1
  13. package/dist/client.d.ts.map +1 -1
  14. package/dist/client.js +38 -1
  15. package/dist/client.js.map +1 -1
  16. package/dist/dispatcher.d.ts +145 -3
  17. package/dist/dispatcher.d.ts.map +1 -1
  18. package/dist/dispatcher.js +602 -24
  19. package/dist/dispatcher.js.map +1 -1
  20. package/dist/errors.d.ts +1 -1
  21. package/dist/errors.d.ts.map +1 -1
  22. package/dist/errors.js.map +1 -1
  23. package/dist/guards.d.ts +3 -2
  24. package/dist/guards.d.ts.map +1 -1
  25. package/dist/guards.js +4 -3
  26. package/dist/guards.js.map +1 -1
  27. package/dist/host.d.ts +9 -0
  28. package/dist/host.d.ts.map +1 -1
  29. package/dist/host.js +2 -0
  30. package/dist/host.js.map +1 -1
  31. package/dist/index.d.ts +16 -8
  32. package/dist/index.d.ts.map +1 -1
  33. package/dist/index.js +8 -4
  34. package/dist/index.js.map +1 -1
  35. package/dist/inputs.d.ts +100 -1
  36. package/dist/inputs.d.ts.map +1 -1
  37. package/dist/inputs.js +35 -1
  38. package/dist/inputs.js.map +1 -1
  39. package/dist/job-record.d.ts +1 -0
  40. package/dist/job-record.d.ts.map +1 -1
  41. package/dist/job-record.js +1 -0
  42. package/dist/job-record.js.map +1 -1
  43. package/dist/letters.d.ts.map +1 -1
  44. package/dist/letters.js +23 -1
  45. package/dist/letters.js.map +1 -1
  46. package/dist/permit.d.ts +43 -0
  47. package/dist/permit.d.ts.map +1 -0
  48. package/dist/permit.js +118 -0
  49. package/dist/permit.js.map +1 -0
  50. package/dist/person-channel.d.ts +45 -0
  51. package/dist/person-channel.d.ts.map +1 -0
  52. package/dist/person-channel.js +160 -0
  53. package/dist/person-channel.js.map +1 -0
  54. package/dist/person-inbox.d.ts +31 -0
  55. package/dist/person-inbox.d.ts.map +1 -0
  56. package/dist/person-inbox.js +69 -0
  57. package/dist/person-inbox.js.map +1 -0
  58. package/dist/person.d.ts +65 -0
  59. package/dist/person.d.ts.map +1 -0
  60. package/dist/person.js +31 -0
  61. package/dist/person.js.map +1 -0
  62. package/dist/protocol.d.ts +8 -1
  63. package/dist/protocol.d.ts.map +1 -1
  64. package/dist/protocol.js +7 -1
  65. package/dist/protocol.js.map +1 -1
  66. package/dist/rights/index.d.ts +36 -0
  67. package/dist/rights/index.d.ts.map +1 -0
  68. package/dist/rights/index.js +186 -0
  69. package/dist/rights/index.js.map +1 -0
  70. package/dist/server.d.ts.map +1 -1
  71. package/dist/server.js +11 -0
  72. package/dist/server.js.map +1 -1
  73. package/dist/setup/claude.d.ts +4 -2
  74. package/dist/setup/claude.d.ts.map +1 -1
  75. package/dist/setup/claude.js +9 -3
  76. package/dist/setup/claude.js.map +1 -1
  77. package/dist/store/sqlite.d.ts +6 -1
  78. package/dist/store/sqlite.d.ts.map +1 -1
  79. package/dist/store/sqlite.js +74 -18
  80. package/dist/store/sqlite.js.map +1 -1
  81. package/dist/store/store.d.ts +6 -2
  82. package/dist/store/store.d.ts.map +1 -1
  83. package/dist/testing/fake-harnesses.d.ts +15 -2
  84. package/dist/testing/fake-harnesses.d.ts.map +1 -1
  85. package/dist/testing/fake-harnesses.js +17 -2
  86. package/dist/testing/fake-harnesses.js.map +1 -1
  87. package/dist/tools/guidance.d.ts.map +1 -1
  88. package/dist/tools/guidance.js +1 -0
  89. package/dist/tools/guidance.js.map +1 -1
  90. package/dist/tools/tools.d.ts.map +1 -1
  91. package/dist/tools/tools.js +27 -4
  92. package/dist/tools/tools.js.map +1 -1
  93. package/dist/types.d.ts +87 -1
  94. package/dist/types.d.ts.map +1 -1
  95. package/dist/types.js +31 -0
  96. package/dist/types.js.map +1 -1
  97. package/fakes/claude.mjs +175 -8
  98. package/fakes/lib.mjs +58 -7
  99. package/fakes/mcp.mjs +5 -1
  100. package/package.json +6 -1
@@ -0,0 +1,160 @@
1
+ import { randomBytes } from 'node:crypto';
2
+ /** What the data of the route's buttons starts with. A press with other data is not its own. */
3
+ const BUTTON_PREFIX = 'bridge:';
4
+ const ALLOW = 'a';
5
+ const DENY = 'd';
6
+ function asError(error) {
7
+ return error instanceof Error ? error : new Error(String(error));
8
+ }
9
+ function messageOf({ letter, job, again }, call) {
10
+ return [
11
+ `${again ? 'Still waiting. ' : ''}Job #${job.number} "${job.title}" in ${job.project}`,
12
+ `${letter.from} ${call ? 'asks leave' : 'asks'}:`,
13
+ '',
14
+ letter.body,
15
+ '',
16
+ call ? 'Allow or refuse with the buttons.' : 'Reply to this message with your answer.',
17
+ ].join('\n');
18
+ }
19
+ /**
20
+ * Reaches the person in a chat of a messaging channel, such as Telegram: a letter that waits
21
+ * for them arrives as a message, a permission request with Allow and Refuse buttons under it, a
22
+ * question to be answered by replying to it. What they press or write goes to the bridge as
23
+ * their answer. Only the one chat is listened to, and in it only `userIds` when given.
24
+ *
25
+ * Which message stands for which letter is kept in memory: after a restart `start` tells the
26
+ * person again of what still waits, and a button of an older message says it is not open any
27
+ * more. Give the route a bot of its own: a channel hands its messages to one handler.
28
+ *
29
+ * @example
30
+ * ```ts
31
+ * import { telegramChannel } from '@cogitator-ai/channels';
32
+ *
33
+ * const telegram = channelRoute({ channel: telegramChannel({ token }), chatId: '123456' });
34
+ * const host = await hostBridge({ person: personRoutes([inboxRoute(inbox), telegram]) });
35
+ * await telegram.start();
36
+ * ```
37
+ */
38
+ export function channelRoute(options) {
39
+ const { channel, chatId } = options;
40
+ const onError = options.onError ?? (() => undefined);
41
+ const shown = new Map();
42
+ const byToken = new Map();
43
+ const byMessage = new Map();
44
+ let bridge;
45
+ let started = false;
46
+ const mayAnswer = (from) => from.channelId === chatId &&
47
+ (options.userIds === undefined || options.userIds.includes(from.userId));
48
+ async function ask(request) {
49
+ const { letter } = request;
50
+ const call = letter.kind === 'permission' && letter.ask !== undefined;
51
+ const known = shown.get(letter.id);
52
+ const entry = known ?? {
53
+ token: randomBytes(6).toString('hex'),
54
+ call,
55
+ from: letter.from,
56
+ messages: [],
57
+ };
58
+ shown.set(letter.id, entry);
59
+ byToken.set(entry.token, letter.id);
60
+ const messageId = await channel.sendText(chatId, messageOf(request, call), {
61
+ format: 'plain',
62
+ ...(call && {
63
+ buttons: [
64
+ [
65
+ { text: 'Allow', data: `${BUTTON_PREFIX}${ALLOW}:${entry.token}`, style: 'success' },
66
+ { text: 'Refuse', data: `${BUTTON_PREFIX}${DENY}:${entry.token}`, style: 'danger' },
67
+ ],
68
+ ],
69
+ }),
70
+ });
71
+ entry.messages.push(messageId);
72
+ byMessage.set(messageId, letter.id);
73
+ }
74
+ async function settle({ letter }) {
75
+ const entry = shown.get(letter.id);
76
+ if (!entry)
77
+ return;
78
+ shown.delete(letter.id);
79
+ byToken.delete(entry.token);
80
+ for (const messageId of entry.messages) {
81
+ byMessage.delete(messageId);
82
+ if (entry.call)
83
+ await channel.editButtons?.(chatId, messageId, null).catch(onError);
84
+ }
85
+ }
86
+ async function pressed(action) {
87
+ if (!action.data.startsWith(BUTTON_PREFIX))
88
+ return;
89
+ const say = (text, alert = false) => channel.answerAction?.(action.id, { text, alert }) ?? Promise.resolve();
90
+ const [kind, token] = action.data.slice(BUTTON_PREFIX.length).split(':');
91
+ const verdict = kind === ALLOW ? 'allow' : kind === DENY ? 'deny' : undefined;
92
+ const letter = token === undefined ? undefined : byToken.get(token);
93
+ if (!mayAnswer(action))
94
+ return say('This is not yours to answer', true);
95
+ if (!bridge || !verdict || !letter)
96
+ return say('This request is not open any more', true);
97
+ try {
98
+ await bridge.personAnswer({ letter, verdict });
99
+ await say(verdict === 'allow' ? 'Allowed' : 'Refused');
100
+ }
101
+ catch (error) {
102
+ await say(asError(error).message, true);
103
+ }
104
+ }
105
+ async function written(message) {
106
+ if (!mayAnswer(message) || message.replyTo === undefined)
107
+ return;
108
+ const letter = byMessage.get(message.replyTo);
109
+ const entry = letter === undefined ? undefined : shown.get(letter);
110
+ if (!bridge || letter === undefined || !entry)
111
+ return;
112
+ const say = (text) => channel.sendText(chatId, text, { format: 'plain', replyTo: message.id });
113
+ if (entry.call) {
114
+ await say('This one takes a decision: use the buttons under it.');
115
+ return;
116
+ }
117
+ if (message.text.trim() === '') {
118
+ await say('The answer is empty. Reply with words.');
119
+ return;
120
+ }
121
+ try {
122
+ await bridge.personAnswer({ letter, body: message.text });
123
+ await say(`Sent to ${entry.from}.`);
124
+ }
125
+ catch (error) {
126
+ await say(asError(error).message);
127
+ }
128
+ }
129
+ return {
130
+ attach(calls) {
131
+ bridge = calls;
132
+ },
133
+ ask,
134
+ settle,
135
+ async tell({ jobs, text }) {
136
+ const about = jobs.map((job) => `#${job.number} "${job.title}"`).join(', ');
137
+ await channel.sendText(chatId, `${text}\nIt stands still: job ${about}.`, {
138
+ format: 'plain',
139
+ });
140
+ },
141
+ async start() {
142
+ if (started)
143
+ return;
144
+ started = true;
145
+ channel.onMessage((message) => written(message).catch(onError));
146
+ channel.onAction?.((action) => pressed(action).catch(onError));
147
+ await channel.start();
148
+ for (const waited of (await bridge?.forPerson()) ?? []) {
149
+ await ask({ ...waited, again: true }).catch(onError);
150
+ }
151
+ },
152
+ async stop() {
153
+ if (!started)
154
+ return;
155
+ started = false;
156
+ await channel.stop();
157
+ },
158
+ };
159
+ }
160
+ //# sourceMappingURL=person-channel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"person-channel.js","sourceRoot":"","sources":["../src/person-channel.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import type { InboxItem, InboxItemInput } from '@cogitator-ai/types';
2
+ import type { PersonRoute } from './person.js';
3
+ /** As much of an inbox as the route uses. `experimental_Inbox` of `@cogitator-ai/core` fits. */
4
+ export interface PersonInbox {
5
+ add(item: InboxItemInput): Promise<InboxItem>;
6
+ claimAnswer(id: string): Promise<InboxItem | null>;
7
+ archive(id: string): Promise<InboxItem | null>;
8
+ }
9
+ /** The id of the inbox item of a letter that waits for the person. */
10
+ export declare function inboxItemId(letterId: string): string;
11
+ /**
12
+ * Puts every letter that waits for the person into an inbox, so whatever shows the inbox or
13
+ * listens to it (a sink, Studio, a webhook) shows the letter: a permission request as an
14
+ * approval, a question as a question. The item says which letter of the bridge it stands for
15
+ * in `metadata.bridge`. A reminder puts the item back as unread, which tells the sinks again.
16
+ * Once the letter waits no more, the item is marked answered and archived. An agent that waits
17
+ * for the person at its own window is an item too, one that takes no answer here.
18
+ *
19
+ * The inbox only shows: the answer itself goes to the bridge, with `cogitator bridge allow`,
20
+ * `deny` and `reply` or through a route that takes answers, such as `channelRoute`.
21
+ *
22
+ * @example
23
+ * ```ts
24
+ * import { experimental_FileInboxStore, experimental_Inbox } from '@cogitator-ai/core';
25
+ *
26
+ * const inbox = new experimental_Inbox({ store: new experimental_FileInboxStore(path) });
27
+ * const host = await hostBridge({ person: inboxRoute(inbox) });
28
+ * ```
29
+ */
30
+ export declare function inboxRoute(inbox: PersonInbox): PersonRoute;
31
+ //# sourceMappingURL=person-inbox.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"person-inbox.d.ts","sourceRoot":"","sources":["../src/person-inbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,gGAAgG;AAChG,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CAChD;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AA4BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAmB1D"}
@@ -0,0 +1,69 @@
1
+ /** The id of the inbox item of a letter that waits for the person. */
2
+ export function inboxItemId(letterId) {
3
+ return `inbox_bridge_${letterId}`;
4
+ }
5
+ function itemOf({ letter, job }) {
6
+ const call = letter.kind === 'permission' && letter.ask !== undefined;
7
+ return {
8
+ id: inboxItemId(letter.id),
9
+ kind: call ? 'approval' : 'question',
10
+ title: `${letter.from} ${call ? 'asks leave' : 'asks'} on job #${job.number}: ${job.title}`,
11
+ summary: letter.body,
12
+ body: letter.body,
13
+ actions: call
14
+ ? [
15
+ { id: 'allow', label: 'Allow', kind: 'approve' },
16
+ { id: 'deny', label: 'Refuse', kind: 'reject' },
17
+ ]
18
+ : [{ id: 'reply', label: 'Reply', kind: 'reply' }],
19
+ metadata: {
20
+ bridge: {
21
+ job: job.number,
22
+ letter: letter.id,
23
+ from: letter.from,
24
+ project: job.project,
25
+ ...(letter.ask && { ask: letter.ask }),
26
+ },
27
+ },
28
+ };
29
+ }
30
+ /**
31
+ * Puts every letter that waits for the person into an inbox, so whatever shows the inbox or
32
+ * listens to it (a sink, Studio, a webhook) shows the letter: a permission request as an
33
+ * approval, a question as a question. The item says which letter of the bridge it stands for
34
+ * in `metadata.bridge`. A reminder puts the item back as unread, which tells the sinks again.
35
+ * Once the letter waits no more, the item is marked answered and archived. An agent that waits
36
+ * for the person at its own window is an item too, one that takes no answer here.
37
+ *
38
+ * The inbox only shows: the answer itself goes to the bridge, with `cogitator bridge allow`,
39
+ * `deny` and `reply` or through a route that takes answers, such as `channelRoute`.
40
+ *
41
+ * @example
42
+ * ```ts
43
+ * import { experimental_FileInboxStore, experimental_Inbox } from '@cogitator-ai/core';
44
+ *
45
+ * const inbox = new experimental_Inbox({ store: new experimental_FileInboxStore(path) });
46
+ * const host = await hostBridge({ person: inboxRoute(inbox) });
47
+ * ```
48
+ */
49
+ export function inboxRoute(inbox) {
50
+ return {
51
+ async ask(request) {
52
+ await inbox.add(itemOf(request));
53
+ },
54
+ async settle({ letter }) {
55
+ const id = inboxItemId(letter.id);
56
+ await inbox.claimAnswer(id);
57
+ await inbox.archive(id);
58
+ },
59
+ async tell({ agent, jobs, text }) {
60
+ await inbox.add({
61
+ kind: 'result',
62
+ title: `${agent} waits for you at its own window`,
63
+ summary: text,
64
+ metadata: { bridge: { agent, jobs: jobs.map((job) => job.number) } },
65
+ });
66
+ },
67
+ };
68
+ }
69
+ //# sourceMappingURL=person-inbox.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"person-inbox.js","sourceRoot":"","sources":["../src/person-inbox.ts"],"names":[],"mappings":"AAUA,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,gBAAgB,QAAQ,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,EAAgB;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC;IACtE,OAAO;QACL,EAAE,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;QACpC,KAAK,EAAE,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE;QAC3F,OAAO,EAAE,MAAM,CAAC,IAAI;QACpB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,IAAI;YACX,CAAC,CAAC;gBACE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;gBAChD,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;aAChD;YACH,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACpD,QAAQ,EAAE;YACR,MAAM,EAAE;gBACN,GAAG,EAAE,GAAG,CAAC,MAAM;gBACf,MAAM,EAAE,MAAM,CAAC,EAAE;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;aACvC;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,OAAO;YACf,MAAM,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE;YACrB,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC5B,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE;YAC9B,MAAM,KAAK,CAAC,GAAG,CAAC;gBACd,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG,KAAK,kCAAkC;gBACjD,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE;aACrE,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,65 @@
1
+ import type { PersonAnswerInput, SendLetterResult } from './inputs.js';
2
+ import type { AgentRecord, BridgeJob, PermissionAsk, RenderedLetter, Rights } from './types.js';
3
+ /** What a permission request is judged by. */
4
+ export interface RightsQuestion {
5
+ job: BridgeJob;
6
+ /** The agent that handed the job over, absent when the bridge does not know it any more */
7
+ delegator: AgentRecord | undefined;
8
+ /** The call the one carrying the job out asks leave for */
9
+ ask: PermissionAsk;
10
+ }
11
+ /**
12
+ * Says what the rules of the agent that handed a job over make of a call: its own to allow, the
13
+ * person's to decide, or forbidden. The bridge asks it for every permission request that names
14
+ * its call, so an agent carrying a job out never gets leave the one who handed it over does not
15
+ * have. Without a judge every such request is the person's to decide.
16
+ */
17
+ export type RightsJudge = (question: RightsQuestion) => Rights | Promise<Rights>;
18
+ /** A letter that waits for the person, with the job it is about. */
19
+ export interface PersonLetter {
20
+ /** The question or the permission request, with the text its recipient sees */
21
+ letter: RenderedLetter;
22
+ job: BridgeJob;
23
+ }
24
+ /** Something the person should know that takes no answer through the bridge. */
25
+ export interface PersonNotice {
26
+ /** The agent it is about */
27
+ agent: string;
28
+ /** The jobs that stand still because of it */
29
+ jobs: BridgeJob[];
30
+ text: string;
31
+ }
32
+ /** A letter the person is told of. */
33
+ export interface PersonRequest extends PersonLetter {
34
+ /** The person was told of it before and has not answered: this is the reminder */
35
+ again: boolean;
36
+ }
37
+ /** The bridge as a route to the person calls it. Whoever calls it speaks for the person. */
38
+ export interface PersonCalls {
39
+ personAnswer(input: PersonAnswerInput): Promise<SendLetterResult>;
40
+ forPerson(): Promise<PersonLetter[]>;
41
+ }
42
+ /**
43
+ * How the bridge reaches the person at the machine: an inbox, a chat, whatever shows them a
44
+ * letter that waits for their word. A route that also takes their answer hands it to the bridge
45
+ * it was attached to.
46
+ */
47
+ export interface PersonRoute {
48
+ /** The bridge the route serves, given once before anything else */
49
+ attach?(bridge: PersonCalls): void;
50
+ /** A letter waits for the person. Called again, with `again`, when they are reminded */
51
+ ask(request: PersonRequest): void | Promise<void>;
52
+ /** The letter waits no more: it was answered, by the person or not, or its job is over */
53
+ settle(waited: PersonLetter): void | Promise<void>;
54
+ /**
55
+ * Something for the person to know: an agent waits for them at its own window, where only
56
+ * they can answer. A route that does not take notices leaves it out
57
+ */
58
+ tell?(notice: PersonNotice): void | Promise<void>;
59
+ }
60
+ /**
61
+ * Several routes as one: the person is told on each. A route that fails does not keep the
62
+ * others from being told, and what failed is thrown once all were tried.
63
+ */
64
+ export declare function personRoutes(routes: readonly PersonRoute[]): PersonRoute;
65
+ //# sourceMappingURL=person.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"person.d.ts","sourceRoot":"","sources":["../src/person.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEhG,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,SAAS,CAAC;IACf,2FAA2F;IAC3F,SAAS,EAAE,WAAW,GAAG,SAAS,CAAC;IACnC,2DAA2D;IAC3D,GAAG,EAAE,aAAa,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjF,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,kFAAkF;IAClF,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,MAAM,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,wFAAwF;IACxF,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,0FAA0F;IAC1F,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD;;;OAGG;IACH,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,CAqBxE"}
package/dist/person.js ADDED
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Several routes as one: the person is told on each. A route that fails does not keep the
3
+ * others from being told, and what failed is thrown once all were tried.
4
+ */
5
+ export function personRoutes(routes) {
6
+ const each = async (tell) => {
7
+ const failed = [];
8
+ for (const route of routes) {
9
+ try {
10
+ await tell(route);
11
+ }
12
+ catch (error) {
13
+ failed.push(error);
14
+ }
15
+ }
16
+ if (failed.length === 1)
17
+ throw failed[0];
18
+ if (failed.length > 1)
19
+ throw new AggregateError(failed, 'Several routes to the person failed');
20
+ };
21
+ return {
22
+ attach: (bridge) => {
23
+ for (const route of routes)
24
+ route.attach?.(bridge);
25
+ },
26
+ ask: (request) => each((route) => route.ask(request)),
27
+ settle: (waited) => each((route) => route.settle(waited)),
28
+ tell: (notice) => each((route) => route.tell?.(notice)),
29
+ };
30
+ }
31
+ //# sourceMappingURL=person.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"person.js","sourceRoot":"","sources":["../src/person.ts"],"names":[],"mappings":"AAmEA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA8B;IACzD,MAAM,IAAI,GAAG,KAAK,EAAE,IAAkD,EAAiB,EAAE;QACvF,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,cAAc,CAAC,MAAM,EAAE,qCAAqC,CAAC,CAAC;IACjG,CAAC,CAAC;IACF,OAAO;QACL,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YACjB,KAAK,MAAM,KAAK,IAAI,MAAM;gBAAE,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC;QACD,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;KACxD,CAAC;AACJ,CAAC"}
@@ -4,7 +4,7 @@ import { BridgeError } from './errors.js';
4
4
  import { type AgentRecord } from './types.js';
5
5
  import type { DispatcherStatus } from './dispatcher.js';
6
6
  /** The version of the protocol the dispatcher speaks on its socket. */
7
- export declare const BRIDGE_PROTOCOL_VERSION = 1;
7
+ export declare const BRIDGE_PROTOCOL_VERSION = 2;
8
8
  /** The JSON-RPC methods of the dispatcher. */
9
9
  export declare const BRIDGE_METHODS: {
10
10
  readonly hello: "bridge/hello";
@@ -18,8 +18,14 @@ export declare const BRIDGE_METHODS: {
18
18
  readonly acknowledge: "letters/acknowledge";
19
19
  readonly wait: "letters/wait";
20
20
  readonly delivered: "letters/delivered";
21
+ readonly escalate: "letters/escalate";
22
+ readonly verdict: "letters/verdict";
23
+ readonly withdraw: "letters/withdraw";
21
24
  readonly listLetters: "letters/list";
25
+ readonly forPerson: "person/letters";
26
+ readonly personAnswer: "person/answer";
22
27
  readonly listAgents: "agents/list";
28
+ readonly stuck: "agents/stuck";
23
29
  readonly readJournal: "journal/read";
24
30
  readonly subscribeJournal: "journal/subscribe";
25
31
  readonly unsubscribeJournal: "journal/unsubscribe";
@@ -39,6 +45,7 @@ export declare const HelloParamsSchema: z.ZodObject<{
39
45
  project: z.ZodOptional<z.ZodString>;
40
46
  sessionName: z.ZodOptional<z.ZodString>;
41
47
  agentName: z.ZodOptional<z.ZodString>;
48
+ permissionMode: z.ZodOptional<z.ZodString>;
42
49
  }, z.core.$strict>>;
43
50
  protocol: z.ZodOptional<z.ZodNumber>;
44
51
  }, z.core.$strip>;
@@ -1 +1 @@
1
- {"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,WAAW,EAAwB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,8CAA8C;AAC9C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;CAiBjB,CAAC;AAEX,qDAAqD;AACrD,eAAO,MAAM,oBAAoB;IAC/B,+DAA+D;;CAEvD,CAAC;AAEX,mGAAmG;AACnG,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,eAAO,MAAM,iBAAiB;;;;;;;;;;iBAI5B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;iBAAiD,CAAC;AAEpF,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;iBAAmD,CAAC;AAExF,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;iBAGvC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,cAAc,CAAC;IAC3B,oEAAoE;IACpE,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAM/D;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWxD"}
1
+ {"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,WAAW,EAAwB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,8CAA8C;AAC9C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;CAuBjB,CAAC;AAEX,qDAAqD;AACrD,eAAO,MAAM,oBAAoB;IAC/B,+DAA+D;;CAEvD,CAAC;AAEX,mGAAmG;AACnG,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAI5B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;iBAAiD,CAAC;AAEpF,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;iBAAmD,CAAC;AAExF,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;iBAGvC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,cAAc,CAAC;IAC3B,oEAAoE;IACpE,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAM/D;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWxD"}
package/dist/protocol.js CHANGED
@@ -3,7 +3,7 @@ import { JsonRpcCallError } from '@cogitator-ai/server-shared';
3
3
  import { BridgeError } from './errors.js';
4
4
  import { CallerIdentitySchema } from './types.js';
5
5
  /** The version of the protocol the dispatcher speaks on its socket. */
6
- export const BRIDGE_PROTOCOL_VERSION = 1;
6
+ export const BRIDGE_PROTOCOL_VERSION = 2;
7
7
  /** The JSON-RPC methods of the dispatcher. */
8
8
  export const BRIDGE_METHODS = {
9
9
  hello: 'bridge/hello',
@@ -17,8 +17,14 @@ export const BRIDGE_METHODS = {
17
17
  acknowledge: 'letters/acknowledge',
18
18
  wait: 'letters/wait',
19
19
  delivered: 'letters/delivered',
20
+ escalate: 'letters/escalate',
21
+ verdict: 'letters/verdict',
22
+ withdraw: 'letters/withdraw',
20
23
  listLetters: 'letters/list',
24
+ forPerson: 'person/letters',
25
+ personAnswer: 'person/answer',
21
26
  listAgents: 'agents/list',
27
+ stuck: 'agents/stuck',
22
28
  readJournal: 'journal/read',
23
29
  subscribeJournal: 'journal/subscribe',
24
30
  unsubscribeJournal: 'journal/unsubscribe',
@@ -1 +1 @@
1
- {"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ import { type PermissionMode, type PermissionSettingsOptions } from '@cogitator-ai/types';
2
+ import type { RightsJudge } from '../person.js';
3
+ export interface SettingsRightsOptions {
4
+ /**
5
+ * Which settings files are read, as `loadPermissionSettings` takes them. The project root is
6
+ * always the project of the job
7
+ */
8
+ settings?: Omit<PermissionSettingsOptions, 'root'>;
9
+ /**
10
+ * The mode of an agent that told the bridge none. Default: `defaultMode` of the settings, else
11
+ * `default`
12
+ */
13
+ mode?: PermissionMode;
14
+ }
15
+ /**
16
+ * A judge of permission requests that reads the rights of the agent that handed a job over from
17
+ * the permission settings of the job's project: the `.claude/` and `.cogitator/` files of the
18
+ * project, of the person and of the machine, the ones Claude Code and Cogitator's own agents
19
+ * obey there. The mode is the one the agent told the bridge it runs in.
20
+ *
21
+ * A call those rules allow is the agent's own to allow, one they forbid is forbidden to the
22
+ * agent it handed the job to as well, and anything they would ask a person about is the
23
+ * person's. A change to one of the settings files themselves is never the agent's to allow,
24
+ * whatever the rules and the mode say, and neither is a command that names their folders: an
25
+ * agent must not write the rules it is judged by.
26
+ *
27
+ * @example
28
+ * ```ts
29
+ * import { hostBridge } from '@cogitator-ai/bridge';
30
+ * import { settingsRights } from '@cogitator-ai/bridge/rights';
31
+ *
32
+ * const host = await hostBridge({ rights: settingsRights() });
33
+ * ```
34
+ */
35
+ export declare function settingsRights(options?: SettingsRightsOptions): RightsJudge;
36
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rights/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAE/B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;IACnD;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAuJD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,WAAW,CAgC/E"}