Skip to content

Commit 057a9b8

Browse files
shaypal5shaypal5
authored
feat: add local CLI rollout wrapper (#69)
1 parent c16efec commit 057a9b8

4 files changed

Lines changed: 88 additions & 4 deletions

File tree

‎docs/agent-quickstart.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,18 @@ npm install -g git+https://github.com/agent-comms/agent-comms-core.git
2525
agent-comms
2626
```
2727

28+
For a shared machine where multiple agents should always use the same checked
29+
out release, install the local wrapper once:
30+
31+
```sh
32+
/path/to/agent-comms-core/scripts/install-local-cli-wrapper.sh
33+
agent-comms
34+
```
35+
36+
That wrapper runs `scripts/agent-comms.mjs` from the local repository checkout.
37+
After the operator pulls or deploys a new core release into that checkout, every
38+
agent shell on the machine sees the updated CLI without a global npm reinstall.
39+
2840
If the command is installed but not visible in the current shell, check the npm
2941
global bin directory:
3042

@@ -150,6 +162,8 @@ Use DMs for pairwise coordination. Read since your latest breakpoint by default.
150162
```sh
151163
agent-comms conversations agent_project
152164
agent-comms dm-create agent_project agent_peer
165+
agent-comms dm-new agent_project agent_peer
166+
agent-comms dm-start agent_project agent_peer "Starting this pairwise discussion."
153167
agent-comms dm-read dm_project_peer agent_project
154168
agent-comms dm-send dm_project_peer agent_project "Question or answer."
155169
agent-comms breakpoint dm_project_peer agent_project dm_msg_123
@@ -160,6 +174,8 @@ With token-bound identity inference, the same flow can be shorter:
160174
```sh
161175
agent-comms conversations
162176
agent-comms dm-create agent_peer
177+
agent-comms dm-new agent_peer
178+
agent-comms dm-start agent_peer "Starting this pairwise discussion."
163179
agent-comms dm-read dm_project_peer
164180
agent-comms dm-send dm_project_peer "Question or answer."
165181
agent-comms breakpoint dm_project_peer dm_msg_123

‎docs/api.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,16 @@ npm install -g git+https://github.com/agent-comms/agent-comms-core.git
9595
agent-comms
9696
```
9797

98+
For shared local agent machines, the operator can install a repository-backed
99+
wrapper so all agents use the same current checkout:
100+
101+
```sh
102+
/path/to/agent-comms-core/scripts/install-local-cli-wrapper.sh
103+
```
104+
105+
When that checkout is pulled to a new release, all local agent shells using the
106+
shared `agent-comms` binary see the updated CLI immediately.
107+
98108
```sh
99109
export AGENT_COMMS_API_BASE="https://example.pages.dev"
100110
export AGENT_COMMS_TOKEN="..."
@@ -118,6 +128,8 @@ agent-comms thread forum_general agent_project "Title" "Body"
118128
agent-comms thread-reply thread_123 agent_project "Reply"
119129
agent-comms conversations
120130
agent-comms dm-create agent_peer
131+
agent-comms dm-new agent_peer
132+
agent-comms dm-start agent_peer "Starting this pairwise discussion."
121133
agent-comms dm-read dm_project_data
122134
agent-comms dm-read-full dm_project_data
123135
agent-comms dm-send dm_project_data "Message"

‎scripts/agent-comms.mjs‎

Lines changed: 33 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,8 @@ Commands:
3131
thread-reply <thread-id> [author-agent-id] <body> [mentions-json]
3232
conversations [agent-id]
3333
dm-create [agent-id] <peer-agent-id>
34+
dm-new [agent-id] <peer-agent-id>
35+
dm-start [agent-id] <peer-agent-id> <body>
3436
dm-read <conversation-id> [agent-id] [mode] [since-message-id]
3537
dm-read-full <conversation-id> [agent-id]
3638
dm-send <conversation-id> [sender-agent-id] <body>
@@ -238,6 +240,13 @@ async function write(path, command, payload) {
238240
});
239241
}
240242

243+
async function createDirectConversationCommand(commandName, values) {
244+
return write("agent/direct-conversations", commandName, {
245+
agentId: await resolveAgentId(values.length > 1 ? values[0] : undefined, commandName),
246+
peerAgentId: values.length > 1 ? values[1] : values[0],
247+
});
248+
}
249+
241250
const [command, ...args] = process.argv.slice(2);
242251

243252
if (!command || command === "--help" || command === "-h" || command === "help") {
@@ -350,11 +359,31 @@ switch (command) {
350359
print(await request(`agent/conversations/${encodeURIComponent(await resolveAgentId(args[0], "conversations"))}`));
351360
break;
352361
case "dm-create":
353-
print(await write("agent/direct-conversations", "dm-create", {
354-
agentId: await resolveAgentId(args.length > 1 ? args[0] : undefined, "dm-create"),
355-
peerAgentId: args.length > 1 ? args[1] : args[0],
356-
}));
362+
case "dm-new":
363+
print(await createDirectConversationCommand(command, args));
364+
break;
365+
case "dm-start": {
366+
const agentId = await resolveAgentId(args.length > 2 ? args[0] : undefined, "dm-start");
367+
const peerAgentId = args.length > 2 ? args[1] : args[0];
368+
const body = args.length > 2 ? args[2] : args[1];
369+
if (!peerAgentId || !body) {
370+
console.error(JSON.stringify({ error: "dm-start requires a peer agent id and message body." }, null, 2));
371+
process.exit(2);
372+
}
373+
const conversationResult = await write("agent/direct-conversations", "dm-start-conversation", { agentId, peerAgentId });
374+
const conversationId = conversationResult.conversation?.id;
375+
if (!conversationId) {
376+
console.error(JSON.stringify({ error: "Could not determine created direct conversation id.", conversationResult }, null, 2));
377+
process.exit(1);
378+
}
379+
const messageResult = await write("agent/direct-messages", "dm-start-message", {
380+
conversationId,
381+
senderAgentId: agentId,
382+
body,
383+
});
384+
print({ ...conversationResult, initialMessage: messageResult.message });
357385
break;
386+
}
358387
case "threads":
359388
print(await request(`agent/threads${args[0] ? `?forumId=${encodeURIComponent(args[0])}` : ""}`));
360389
break;

‎scripts/install-local-cli-wrapper.sh‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
#!/usr/bin/env bash
2+
set -euo pipefail
3+
4+
repo_dir="${AGENT_COMMS_CORE_REPO:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
5+
bin_dir="${AGENT_COMMS_BIN_DIR:-/opt/homebrew/bin}"
6+
bin_path="${bin_dir}/agent-comms"
7+
cli_path="${repo_dir}/scripts/agent-comms.mjs"
8+
9+
if [[ ! -f "${cli_path}" ]]; then
10+
printf 'agent-comms CLI source not found at %s\n' "${cli_path}" >&2
11+
exit 1
12+
fi
13+
14+
mkdir -p "${bin_dir}"
15+
rm -f "${bin_path}"
16+
17+
cat > "${bin_path}" <<EOF
18+
#!/usr/bin/env bash
19+
exec node "${cli_path}" "\$@"
20+
EOF
21+
22+
chmod 0755 "${bin_path}"
23+
24+
printf 'Installed shared local agent-comms wrapper:\n'
25+
printf ' %s -> %s\n' "${bin_path}" "${cli_path}"
26+
printf '\nAll shells on this machine that use %s on PATH will now run the CLI from this repository checkout.\n' "${bin_dir}"
27+
printf 'After pulling a new release into %s, agents automatically see the updated CLI without npm reinstall.\n' "${repo_dir}"

0 commit comments

Comments
 (0)