@cotal-ai/connector-core 0.136.8 → 0.138.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.
- package/dist/agent.d.ts +4 -1
- package/dist/agent.d.ts.map +1 -1
- package/dist/agent.js +3 -6
- package/dist/agent.js.map +1 -1
- package/dist/docs-bundle.bin +0 -0
- package/dist/docs-bundle.generated.d.ts +1 -1
- package/dist/docs-bundle.generated.js +6 -6
- package/dist/docs-index.bin +0 -0
- package/dist/orientation.d.ts.map +1 -1
- package/dist/orientation.js +20 -12
- package/dist/orientation.js.map +1 -1
- package/dist/tool-specs.d.ts +25 -0
- package/dist/tool-specs.d.ts.map +1 -1
- package/dist/tool-specs.js +89 -22
- package/dist/tool-specs.js.map +1 -1
- package/package.json +3 -3
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAmD,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC1H,OAAO,EAAyB,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGzD;;2DAE2D;AAC3D,eAAO,MAAM,qBAAqB,QAEmC,CAAC;AAEtE;;;2GAG2G;AAC3G,eAAO,MAAM,gBAAgB,
|
|
1
|
+
{"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"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"}
|
package/dist/orientation.js
CHANGED
|
@@ -22,11 +22,12 @@ export const ORIENTATION_BOOTSTRAP = "Start with cotal_orientation — it shows
|
|
|
22
22
|
* multi-agent work on the mesh instead of inside the harness's own hidden subagents, so it stays
|
|
23
23
|
* visible to the user and addressable by peers. Unconditional (a read-only agent still delegates via
|
|
24
24
|
* DM/anycast rather than a private subagent); the spawn-specific detail lives on the cotal_spawn tool. */
|
|
25
|
-
export const MESH_FIRST_STEER = "Keep multi-agent work on the mesh.
|
|
26
|
-
"
|
|
27
|
-
"
|
|
28
|
-
"
|
|
29
|
-
"
|
|
25
|
+
export const MESH_FIRST_STEER = "Keep multi-agent work on the mesh. Prefer it to your harness's own subagents, Task tool, or any " +
|
|
26
|
+
"built-in parallel-agent feature: spawn or delegate to a real peer (cotal_spawn if you have it, " +
|
|
27
|
+
"otherwise cotal_dm or cotal_anycast to reach one) so the work stays visible to the user and " +
|
|
28
|
+
"addressable by peers rather than hidden inside a private subagent. Use a harness subagent only for " +
|
|
29
|
+
"a self-contained job nobody else needs to follow. For a single task, cotal_spawn with once: true " +
|
|
30
|
+
"starts a Claude Code, jcode, OpenCode or pi helper that is stopped when the task ends.";
|
|
30
31
|
/** Workflow-run steer, folded in beside {@link MESH_FIRST_STEER} for every connector. Points agents
|
|
31
32
|
* at durable cotal-lang runs for coordination that must outlive their own session, so the reflex is
|
|
32
33
|
* a journalled `cotal run` rather than an improvised loop held in one agent's context. */
|
|
@@ -41,16 +42,23 @@ export const WORKFLOW_STEER = "Coordination that must survive restarts (multi-st
|
|
|
41
42
|
* one. Guidance only: it grants nothing and changes no subscription. */
|
|
42
43
|
export const CHANNEL_GUIDANCE = "Information moves through channels. Subscribe to the channel where what you need is published, " +
|
|
43
44
|
"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
|
|
45
|
-
"
|
|
46
|
-
"
|
|
47
|
-
"
|
|
48
|
-
"
|
|
45
|
+
"on is where your work happens: post plans, status, results and decisions there with cotal_send. " +
|
|
46
|
+
"On a durable channel, the usual kind, every agent on it gets the post unless it muted the channel, " +
|
|
47
|
+
"and one that is offline gets it when it comes back; on a live channel, one that is disconnected or " +
|
|
48
|
+
"busy then misses it, unless the post mentions it by a name only it has and it may read the channel. " +
|
|
49
|
+
"On a channel that replays history, agents who join later are shown it. A post " +
|
|
50
|
+
"wakes an idle agent unless it set dnd or focus or made the channel quiet. @mention a peer only when " +
|
|
51
|
+
"that peer must act now, since a mention wakes it even in dnd, and a mention in an acknowledgement " +
|
|
52
|
+
"or sign-off starts a wake-up loop. When you are " +
|
|
53
|
+
"asked to tell a peer about shared work, such as a status or a result, post it on the channel you " +
|
|
54
|
+
"share and mention that peer there. Use cotal_dm only for something one peer alone needs, such as a " +
|
|
55
|
+
"question only it can answer or a private detail, because other agents can't read a DM. Use " +
|
|
56
|
+
"cotal_anycast only when the team has agents holding a role to take requests. " +
|
|
49
57
|
"A channel's purpose is its registry note (cotal_channel_info); cotal_channels lists them and " +
|
|
50
58
|
"cotal_join adds one within your read allowance. To follow every channel under a prefix, join a " +
|
|
51
59
|
"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
|
|
53
|
-
"pass join
|
|
60
|
+
"join on. A helper you spawn starts only on the channels its persona lists, which may be none, so " +
|
|
61
|
+
"pass join with the channel you are working on. Post on #announce only for a deliberate notice " +
|
|
54
62
|
"to the whole space.";
|
|
55
63
|
/** The everyday loop (the `core` group); every other tool falls into `more`. Keep in sync with the
|
|
56
64
|
* reply/loop tools an agent reaches for each turn. An unknown/new tool defaults to `more`. */
|
package/dist/orientation.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"orientation.js","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAA2C,MAAM,gBAAgB,CAAC;AAC1H,OAAO,EAAE,qBAAqB,EAAmC,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAoB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;2DAE2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAChC,uIAAuI;IACvI,mEAAmE,CAAC;AAEtE;;;2GAG2G;AAC3G,MAAM,CAAC,MAAM,gBAAgB,GAC3B,
|
|
1
|
+
{"version":3,"file":"orientation.js","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"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"}
|
package/dist/tool-specs.d.ts
CHANGED
|
@@ -147,6 +147,31 @@ export declare function sendNoDefaultRemedy(config: Pick<AgentConfig, "allowSubs
|
|
|
147
147
|
* agent can't call. The `cotal_orientation` tool, a connect result and a session-start hook all
|
|
148
148
|
* hand over this one rendering. */
|
|
149
149
|
export declare function orientationCard(agent: MeshAgent, config: AgentConfig, source?: string, env?: NodeJS.ProcessEnv, offered?: ReadonlySet<string>): Promise<string>;
|
|
150
|
+
/** The `cotal_send` success line: where the post went and the next move. It names the channel and
|
|
151
|
+
* any mention and makes no claim about who woke or how many received it, since nothing reports that
|
|
152
|
+
* to the sender. A name that was new before the post says so, with close matches first because a
|
|
153
|
+
* typo is the likely cause, and tells the sender to point others at it. Whether a later joiner is
|
|
154
|
+
* shown the post is the channel's effective replay. */
|
|
155
|
+
export declare function sendResult(channel: string, mentions: readonly string[], receipt: {
|
|
156
|
+
known: boolean;
|
|
157
|
+
hints: readonly string[];
|
|
158
|
+
}, replay: boolean): string;
|
|
159
|
+
/** The `cotal_spawn` line for a seat the manager reports started: who it is, where it is and the next
|
|
160
|
+
* move. It names only the `join` channels the caller passed. The reply carries no channel list, and
|
|
161
|
+
* a persona the caller does not own may list channels the caller cannot read, so without `join` it
|
|
162
|
+
* says the seat has only what its persona lists. A rename leads, so the caller addresses the seat it
|
|
163
|
+
* got. A seat waiting at an operator screen has not joined the mesh yet, and the line says so. A once
|
|
164
|
+
* seat is stopped by its manager, so it is not told to despawn it. */
|
|
165
|
+
export declare function spawnResult(s: {
|
|
166
|
+
requested: string;
|
|
167
|
+
started: string;
|
|
168
|
+
renamed: boolean;
|
|
169
|
+
mode?: string;
|
|
170
|
+
model?: string;
|
|
171
|
+
join?: readonly string[];
|
|
172
|
+
waitingFor?: string;
|
|
173
|
+
once: boolean;
|
|
174
|
+
}): string;
|
|
150
175
|
/** How to reach a channel family, since every publish names one concrete channel (SPEC §3). The
|
|
151
176
|
* advertised `channel` text of `cotal_send`, here and in the gateway. */
|
|
152
177
|
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).";
|
package/dist/tool-specs.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool-specs.d.ts","sourceRoot":"","sources":["../src/tool-specs.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"tool-specs.d.ts","sourceRoot":"","sources":["../src/tool-specs.ts"],"names":[],"mappings":"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"}
|
package/dist/tool-specs.js
CHANGED
|
@@ -586,6 +586,43 @@ export async function orientationCard(agent, config, source, env, offered) {
|
|
|
586
586
|
const visible = cotalToolSpecs(config, source, env, offered).map((s) => ({ name: s.name, title: s.title }));
|
|
587
587
|
return renderOrientation(buildOrientation(agent, config, visible, Date.now(), await agent.readRoster()));
|
|
588
588
|
}
|
|
589
|
+
/** The `cotal_send` success line: where the post went and the next move. It names the channel and
|
|
590
|
+
* any mention and makes no claim about who woke or how many received it, since nothing reports that
|
|
591
|
+
* to the sender. A name that was new before the post says so, with close matches first because a
|
|
592
|
+
* typo is the likely cause, and tells the sender to point others at it. Whether a later joiner is
|
|
593
|
+
* shown the post is the channel's effective replay. */
|
|
594
|
+
export function sendResult(channel, mentions, receipt, replay) {
|
|
595
|
+
const at = `#${channel}`;
|
|
596
|
+
const named = mentions.map((n) => `@${n}`).join(", ");
|
|
597
|
+
if (receipt.known)
|
|
598
|
+
return mentions.length
|
|
599
|
+
? `Posted to ${at} and mentioned ${named}. Agents on it see it too.`
|
|
600
|
+
: `Posted to ${at}. Agents on it see it; mention one to make it act.`;
|
|
601
|
+
const hint = receipt.hints.length ? ` Did you mean ${receipt.hints.map((h) => `#${h}`).join(", ")}?` : "";
|
|
602
|
+
const later = replay
|
|
603
|
+
? "Others see it once they join; tell them where it is."
|
|
604
|
+
: "This channel doesn't replay history, so agents who join later won't see this post. Tell them where it is, and post again once they have joined.";
|
|
605
|
+
return `Posted to ${at}, a new channel${mentions.length ? `, and mentioned ${named}` : ""}.${hint} ${later}`;
|
|
606
|
+
}
|
|
607
|
+
/** The `cotal_spawn` line for a seat the manager reports started: who it is, where it is and the next
|
|
608
|
+
* move. It names only the `join` channels the caller passed. The reply carries no channel list, and
|
|
609
|
+
* a persona the caller does not own may list channels the caller cannot read, so without `join` it
|
|
610
|
+
* says the seat has only what its persona lists. A rename leads, so the caller addresses the seat it
|
|
611
|
+
* got. A seat waiting at an operator screen has not joined the mesh yet, and the line says so. A once
|
|
612
|
+
* seat is stopped by its manager, so it is not told to despawn it. */
|
|
613
|
+
export function spawnResult(s) {
|
|
614
|
+
const lead = s.renamed ? `Started ${s.started} ("${s.requested}" was taken)` : `Started ${s.started}`;
|
|
615
|
+
const facts = [s.mode, s.model ? `recorded model ${JSON.stringify(s.model)}` : undefined].filter(Boolean);
|
|
616
|
+
const about = facts.length ? ` (${facts.join(", ")})` : "";
|
|
617
|
+
const on = s.join?.length ? s.join.map((c) => `#${c}`).join(", ") : undefined;
|
|
618
|
+
const persona = "it starts only on the channels its persona lists, which may be none";
|
|
619
|
+
if (s.waitingFor !== undefined)
|
|
620
|
+
return `${lead}${about}, but it is waiting for the operator at ${s.waitingFor} and joins the mesh after that. ` +
|
|
621
|
+
(on ? `It starts on ${on}.` : `Without join, ${persona}.`);
|
|
622
|
+
if (!on)
|
|
623
|
+
return `${lead}${about} without join, so ${persona}. Pass join to put it on the task's channel.`;
|
|
624
|
+
return `${lead} on ${on}${about}. Post the brief there, and mention it only when it must act.${s.once ? "" : " Despawn it when its job is done."}`;
|
|
625
|
+
}
|
|
589
626
|
/** How to reach a channel family, since every publish names one concrete channel (SPEC §3). The
|
|
590
627
|
* advertised `channel` text of `cotal_send`, here and in the gateway. */
|
|
591
628
|
export 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).";
|
|
@@ -1035,7 +1072,13 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1035
1072
|
{
|
|
1036
1073
|
name: "cotal_send",
|
|
1037
1074
|
title: "Cotal: broadcast to a channel",
|
|
1038
|
-
description: "
|
|
1075
|
+
description: "Post to a channel. Use it for anything more than one agent could use, now or later: briefs, plans, status, decisions, results. " +
|
|
1076
|
+
"Channels deliver in one of two ways. On a durable channel, the usual kind, every agent on it gets the post unless it has muted the channel, and a member that is offline gets it when it comes back. " +
|
|
1077
|
+
"On a live channel, an agent that is disconnected, busy or not yet joined when you post misses it, and nothing is kept for it, unless you mention it: an agent you mention gets a copy if it may read the channel and no other agent has its name. An idle agent is woken by a post, unless it set dnd or focus or made the channel quiet. " +
|
|
1078
|
+
"Separately, most channels replay history: an agent that joins later is shown recent posts, and those old posts don't wake it. cotal_channel_info says whether a channel replays. " +
|
|
1079
|
+
"If only one agent will ever need it, use cotal_dm instead. Give the channel's full name. If you leave it out, the post goes to your default channel, the first one you are on and may post to. " +
|
|
1080
|
+
"To reach a group, post on a channel the group follows, such as review.announce. You can't post to a pattern such as review.>. To reach several channels, post to each one by name; cotal_channels lists them. " +
|
|
1081
|
+
'Example: `{channel: "review.login-page", text: "Review done: two issues, both in the session timeout."}`',
|
|
1039
1082
|
schema: {
|
|
1040
1083
|
text: z.string().describe("The message to broadcast."),
|
|
1041
1084
|
channel: z
|
|
@@ -1045,7 +1088,7 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1045
1088
|
mentions: z
|
|
1046
1089
|
.array(z.string())
|
|
1047
1090
|
.optional()
|
|
1048
|
-
.describe(
|
|
1091
|
+
.describe('The names of agents who must act on this post, for example `mentions: ["reviewer"]`. Only this field counts. Writing @reviewer in the text is not a mention. A mention wakes the agent even in dnd. Never mention anyone in thanks or sign-offs.'),
|
|
1049
1092
|
},
|
|
1050
1093
|
async run(agent, config, { text: msg, channel, mentions }) {
|
|
1051
1094
|
const refusal = channel === undefined ? undefined : sendChannelRefusal(channel);
|
|
@@ -1058,8 +1101,7 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1058
1101
|
return err(`Couldn't send: ${sendNoDefaultRemedy(config, joined)}.`);
|
|
1059
1102
|
const receipt = await agent.describeSendChannel(target);
|
|
1060
1103
|
const m = await agent.send(msg, target, mentions);
|
|
1061
|
-
|
|
1062
|
-
return ok(receipt ? `${dest} (${receipt}).` : `${dest}.`);
|
|
1104
|
+
return ok(sendResult(m.channel ?? target, m.mentions ?? [], receipt, agent.channelInfo(m.channel ?? target).replay));
|
|
1063
1105
|
}
|
|
1064
1106
|
catch (e) {
|
|
1065
1107
|
return err(`Couldn't send: ${e.message}`);
|
|
@@ -1069,7 +1111,8 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1069
1111
|
{
|
|
1070
1112
|
name: "cotal_dm",
|
|
1071
1113
|
title: "Cotal: direct-message a peer",
|
|
1072
|
-
description: "
|
|
1114
|
+
description: "Private message to one agent. Other agents can't read it. It wakes that agent even in dnd, and an offline agent gets it when it comes back. " +
|
|
1115
|
+
"Use it for a question only that agent can answer, or a private detail. To tell an agent about shared work, such as a status or a result, or anything others could use now or later, post it on the task's channel with cotal_send and mention the agent there.",
|
|
1073
1116
|
schema: {
|
|
1074
1117
|
to: z.string().describe("The peer's name (or instance id)."),
|
|
1075
1118
|
text: z.string().describe("The message."),
|
|
@@ -1082,15 +1125,15 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1082
1125
|
try {
|
|
1083
1126
|
const { recipient, ack, recipientStatusAtSend } = await agent.dm(to, msg, { replyTo });
|
|
1084
1127
|
const dup = ack.duplicate ? " duplicate publication." : "";
|
|
1085
|
-
const
|
|
1086
|
-
?
|
|
1087
|
-
:
|
|
1128
|
+
const unrostered = recipientStatusAtSend === "unrostered"
|
|
1129
|
+
? ` ${recipient.name} has no roster row: it messaged you from a connection that never joined the roster or has left it, so the space's DM history keeps this DM under its id and it may never reach an inbox.`
|
|
1130
|
+
: "";
|
|
1088
1131
|
// The DM durable belongs to the recipient's lifecycle (SPEC §8): the same session gets it on
|
|
1089
1132
|
// reconnect, and a new spawn under that name starts after it.
|
|
1090
1133
|
const offline = recipientStatusAtSend === "offline"
|
|
1091
1134
|
? ` ${recipient.name} is offline: the DM is delivered when ${recipient.name} reconnects, and a new agent spawned as ${recipient.name} does not receive it.`
|
|
1092
1135
|
: "";
|
|
1093
|
-
return ok(`
|
|
1136
|
+
return ok(`Sent to ${recipient.name}.${unrostered}${offline} Other agents can't read it. If others could use it, post it on the task's channel.${dup}`);
|
|
1094
1137
|
}
|
|
1095
1138
|
catch (e) {
|
|
1096
1139
|
if (e instanceof AmbiguousPeerError) {
|
|
@@ -1107,7 +1150,10 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1107
1150
|
{
|
|
1108
1151
|
name: "cotal_anycast",
|
|
1109
1152
|
title: "Cotal: ask any agent of a role",
|
|
1110
|
-
description: "
|
|
1153
|
+
description: "Ask whoever holds a role. Use it only when the team was built for it, with agents that hold the role to take requests, such as a pool of reviewers started with cotal_spawn and role. " +
|
|
1154
|
+
"The request waits until one of them takes it, which can take a while if they are all busy. Without such a pool, mention a named agent on the task's channel, send a DM, or spawn a helper. " +
|
|
1155
|
+
"Anycast does not follow the work after someone takes it. To follow work to the end, use cotal_run. " +
|
|
1156
|
+
'Example: `{role: "review-frontend", text: "Review issue #812, the checkout button. Post your findings on #review.checkout."}`',
|
|
1111
1157
|
schema: {
|
|
1112
1158
|
role: z.string().describe("The role to address (e.g. reviewer)."),
|
|
1113
1159
|
text: z.string().describe("The request."),
|
|
@@ -1171,7 +1217,7 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1171
1217
|
{
|
|
1172
1218
|
name: "cotal_channel_info",
|
|
1173
1219
|
title: "Cotal: what a channel is for",
|
|
1174
|
-
description: "
|
|
1220
|
+
description: "Read a channel's purpose and notes before you first post there.",
|
|
1175
1221
|
schema: {
|
|
1176
1222
|
channel: z.string().describe("The channel to look up (e.g. review)."),
|
|
1177
1223
|
},
|
|
@@ -1188,8 +1234,7 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1188
1234
|
{
|
|
1189
1235
|
name: "cotal_channels",
|
|
1190
1236
|
title: "Cotal: list channels",
|
|
1191
|
-
description: "
|
|
1192
|
-
`By default it lists the channels you are on or may join, and counts the agents' event channels and the channels outside your read ACL it leaves out; all: true lists those too. filter narrows by name. A list longer than ${CHANNEL_ROWS} rows ends with the after value that continues it.`,
|
|
1237
|
+
description: "List the channels you are on or may join, with each one's purpose. Check here before making a new channel, and follow the names the space already uses.",
|
|
1193
1238
|
schema: {
|
|
1194
1239
|
filter: z.string().optional().describe("Only channels whose name contains this text (case-insensitive)."),
|
|
1195
1240
|
all: z.boolean().optional().describe("Also list agents' event channels and channels outside your read ACL."),
|
|
@@ -1302,9 +1347,10 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1302
1347
|
{
|
|
1303
1348
|
name: "cotal_join",
|
|
1304
1349
|
title: "Cotal: join a channel",
|
|
1305
|
-
description: "
|
|
1306
|
-
"A family
|
|
1307
|
-
"
|
|
1350
|
+
description: "Join a channel to see its posts. If the channel replays history, you also get its recent posts as catch-up. Join the channel of every task you are part of. You can join only channels your read permission covers. " +
|
|
1351
|
+
"A pattern follows a whole family of channels: review.> covers every channel under review, including ones opened later, but not review itself, and review.* covers one level. Follow a family only if that is your job, because every post in it reaches you. " +
|
|
1352
|
+
"Under a family such as review.>, posts on its durable channels are kept for you while you are offline, from the join on, and its live channels reach you only while you are connected. " +
|
|
1353
|
+
"A pattern with * or the root > is followed live only: posts sent while you are offline are not kept for you. Join a channel by its full name when you must not miss a post.",
|
|
1308
1354
|
schema: {
|
|
1309
1355
|
channel: z.string().describe("The channel to join (e.g. incident), or a family such as team.>."),
|
|
1310
1356
|
},
|
|
@@ -1350,7 +1396,7 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1350
1396
|
{
|
|
1351
1397
|
name: "cotal_leave",
|
|
1352
1398
|
title: "Cotal: leave a channel",
|
|
1353
|
-
description: "
|
|
1399
|
+
description: "Leave a channel when you are done with its task. You stay reachable by DM and anycast.",
|
|
1354
1400
|
schema: {
|
|
1355
1401
|
channel: z.string().describe("The channel or family to leave."),
|
|
1356
1402
|
},
|
|
@@ -1367,7 +1413,14 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1367
1413
|
{
|
|
1368
1414
|
name: "cotal_spawn",
|
|
1369
1415
|
title: "Cotal: spawn a new teammate",
|
|
1370
|
-
description: "
|
|
1416
|
+
description: "Start another agent on the mesh to do a job. It runs as its own process: it shows up on the roster, the user can watch it work, and any agent can message it. " +
|
|
1417
|
+
"A subagent that your own harness starts, such as Claude Code's Task tool, runs inside your session, where nobody else can see or reach it. Prefer cotal_spawn. Use a subagent only for a self-contained job nobody else needs to follow, where it keeps the work contained and can be more efficient, depending on the harness. " +
|
|
1418
|
+
"name picks a saved persona, which sets the new agent's role and what it may do. cotal_personas lists them, and cotal_persona saves a new one. Give it a prompt that says what to do. If others could use its work, put it on the task's channel with join and say in the prompt where the brief is. " +
|
|
1419
|
+
'Example: `{name: "reviewer", join: ["review.login-page"], prompt: "Read the brief on #review.login-page, post your findings there, then despawn yourself."}` ' +
|
|
1420
|
+
"The new agent can read and post wherever its persona allows. An operator's persona that names no channels gets your permissions and no more; one you save with cotal_persona gets only the channels it lists. Give a helper only what its job needs. To limit its channels, write a persona with cotal_persona that lists just the ones it needs, then spawn that persona. " +
|
|
1421
|
+
"Only an operator can let a helper spawn agents or run workflows, and endpoint access also comes from the operator, so ask the user if the job needs them. cotal_orientation shows what you hold. " +
|
|
1422
|
+
"For a single job on a Claude Code, jcode, OpenCode or pi helper, pass once: true with the prompt, and the helper is stopped when it ends that turn; or tell it in the prompt to despawn itself when done, as in the example. A standing teammate keeps running until it despawns itself or you call cotal_despawn. " +
|
|
1423
|
+
"For work with several steps, a wait on a person, or a need to survive restarts, use cotal_run.",
|
|
1371
1424
|
schema: {
|
|
1372
1425
|
name: z.string().describe("Which persona to spawn: the persona FILENAME in .cotal/agents (e.g. `review-critic`), without the .md. The new peer joins under the persona's own `name:` (auto-numbered with an underscore, e.g. socrates_2, if that's taken). Fails if no such persona file exists; spawn an existing persona, don't invent a name."),
|
|
1373
1426
|
join: z
|
|
@@ -1510,7 +1563,7 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1510
1563
|
const task = d?.once
|
|
1511
1564
|
? ` Its task is goal ${JSON.stringify(d.once.goalId)}, ${d.once.deadlineAt !== undefined ? `with a deadline of ${new Date(d.once.deadlineAt).toISOString()}` : "with no deadline"}; it is stopped when the task ends. Read the outcome with cotal_invoke(endpoint="manager", command="goal-result", args={"goalId":${JSON.stringify(d.once.goalId)}}).`
|
|
1512
1565
|
: "";
|
|
1513
|
-
return ok(
|
|
1566
|
+
return ok(spawnResult({ requested: name, started: who, renamed: actual !== name, mode, model: d?.model, join, waitingFor: d?.waitingFor, once: d?.once !== undefined }) + task);
|
|
1514
1567
|
}
|
|
1515
1568
|
catch (e) {
|
|
1516
1569
|
return controlFailure(`Couldn't spawn ${name}`, e);
|
|
@@ -1552,7 +1605,7 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1552
1605
|
{
|
|
1553
1606
|
name: "cotal_despawn",
|
|
1554
1607
|
title: "Cotal: stop a teammate",
|
|
1555
|
-
description: "
|
|
1608
|
+
description: "Stop a helper when its job is done, or stop yourself by leaving out name. The manager that started you then ends your process. This works only for an agent a manager started; a session someone connected by hand is refused. Graceful by default; pass graceful: false only for a hung agent.",
|
|
1556
1609
|
schema: {
|
|
1557
1610
|
name: z
|
|
1558
1611
|
.string()
|
|
@@ -1617,7 +1670,7 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1617
1670
|
{
|
|
1618
1671
|
name: "cotal_run",
|
|
1619
1672
|
title: "Cotal: run a workflow program",
|
|
1620
|
-
description: "Use Cotal Lang to program multi-step coordination between agents: sequence work, run tasks in parallel, branch on results, wait for events, and request human decisions. Agents own their reasoning and conversations; the workflow specifies when they act and which outcomes determine the next step.\n\nBefore writing a program, read cotal_docs pages `workflows` and `lang-card`. Hosted execution requires a running execution-capable manager, the `run` capability, and issued caller authority. A managed agent on a user-auth mesh uses its own bearer command and selected participant manager; both its current grant and its direct parent's current grant must allow `run`. Open meshes, unsupported local user-mode hosts and execution-free control managers refuse hosted runs. `@cotal-ai/lang` provides validation and simulation separately; those are not verbs of this tool.\n\nSTART: pass `verb: \"start\"` and the program text in `source`. Example: `{\"verb\":\"start\",\"source\":\"await sleep(\\\"1s\\\", { name: \\\"first-run\\\" });\"}`. Optional `file` labels diagnostics only; it reads nothing from disk. The manager validates before recording the run and returns a runId. Acceptance is not completion.\n\nINSPECT: use `verb: \"status\"` with that `runId` for state and step journal, or `verb: \"ps\"` to list runs. Both are read-only. Report completion only after observing state `completed`; surface failures or unresolved steps.\n\nANSWER: first inspect status, then pass `verb: \"answer\"`, `runId`, the exact open `stepKey`, and, when requested, `value` matching the answer shape. An ask requires its requested record; a checkpoint can resolve without a value. `artifact` may name the evidence reviewed. Answer only with authority to make that decision; never invent an approval.\n\nRESUME: pass `verb: \"resume\"` and `runId` to continue a run from its recorded source. A held run appears as `released` in status. Do not start a duplicate run to continue it or resume one the manager is already driving.\n\nRuns continue independently of your session and can recover after a manager restart. Their channel effects are bounded by the starting credential's issued channel scope. To report that your assigned agent turn is blocked or handed off, use `cotal_yield` instead. Pass `instance` for the exact manager when an unbound user-auth caller has several managers; a failed pin does not fall back.",
|
|
1673
|
+
description: "Use for coordination with several steps, waits on a person, or work that must survive restarts. For one job done by one helper, use cotal_spawn. Use Cotal Lang to program multi-step coordination between agents: sequence work, run tasks in parallel, branch on results, wait for events, and request human decisions. Agents own their reasoning and conversations; the workflow specifies when they act and which outcomes determine the next step.\n\nBefore writing a program, read cotal_docs pages `workflows` and `lang-card`. Hosted execution requires a running execution-capable manager, the `run` capability, and issued caller authority. A managed agent on a user-auth mesh uses its own bearer command and selected participant manager; both its current grant and its direct parent's current grant must allow `run`. Open meshes, unsupported local user-mode hosts and execution-free control managers refuse hosted runs. `@cotal-ai/lang` provides validation and simulation separately; those are not verbs of this tool.\n\nSTART: pass `verb: \"start\"` and the program text in `source`. Example: `{\"verb\":\"start\",\"source\":\"await sleep(\\\"1s\\\", { name: \\\"first-run\\\" });\"}`. Optional `file` labels diagnostics only; it reads nothing from disk. The manager validates before recording the run and returns a runId. Acceptance is not completion.\n\nINSPECT: use `verb: \"status\"` with that `runId` for state and step journal, or `verb: \"ps\"` to list runs. Both are read-only. Report completion only after observing state `completed`; surface failures or unresolved steps.\n\nANSWER: first inspect status, then pass `verb: \"answer\"`, `runId`, the exact open `stepKey`, and, when requested, `value` matching the answer shape. An ask requires its requested record; a checkpoint can resolve without a value. `artifact` may name the evidence reviewed. Answer only with authority to make that decision; never invent an approval.\n\nRESUME: pass `verb: \"resume\"` and `runId` to continue a run from its recorded source. A held run appears as `released` in status. Do not start a duplicate run to continue it or resume one the manager is already driving.\n\nRuns continue independently of your session and can recover after a manager restart. Their channel effects are bounded by the starting credential's issued channel scope. To report that your assigned agent turn is blocked or handed off, use `cotal_yield` instead. Pass `instance` for the exact manager when an unbound user-auth caller has several managers; a failed pin does not fall back.",
|
|
1621
1674
|
schema: {
|
|
1622
1675
|
verb: z.enum(["start", "status", "ps", "answer", "resume"]).describe("start = validate and drive a new program; status = one run's record + journal; ps = list runs; answer = resolve an open checkpoint/ask; resume = take a released or held run over."),
|
|
1623
1676
|
source: z.string().min(1).optional().describe("start only: the cotal-lang program source, inline. Required for start."),
|
|
@@ -1710,7 +1763,21 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1710
1763
|
{
|
|
1711
1764
|
name: "cotal_persona",
|
|
1712
1765
|
title: "Cotal: define a persona",
|
|
1713
|
-
description: "
|
|
1766
|
+
description: "Save a persona that cotal_spawn can start. Most jobs need a persona written for them. Reuse one from cotal_personas only when it really fits, such as a general reviewer. Every persona you save stays in the user's workspace after the helper stops. " +
|
|
1767
|
+
"Name it after what it does, such as review-login-page. Write the prompt about the job: what to do, where the brief is, how to report, and when to stop. Point to sources for facts rather than stating them. Set role when others should reach it through a role. " +
|
|
1768
|
+
"List its channels and give it only what the job needs: subscribe for where it starts, allowSubscribe for what it may read, and allowPublish for what it may post to. If you list subscribe alone, it may read just those channels and can't post anywhere. Leave all three out and it can read and post nowhere, so list the channels it needs. " +
|
|
1769
|
+
"A persona you save can't let its agent spawn others or run workflows; only an operator can grant that. Only you or an operator can change a persona you saved.\n\n" +
|
|
1770
|
+
"Before you write one, check what you can give. cotal_orientation shows your own channels and capabilities, and cotal_channels lists the channels in the space. cotal_endpoints lists the endpoints you can call, and cotal_describe shows what one lets a caller do. The agent-files page in cotal_docs lists every persona field.\n\n" +
|
|
1771
|
+
"Example:\n\n" +
|
|
1772
|
+
"```\n" +
|
|
1773
|
+
"{\n" +
|
|
1774
|
+
' name: "review-login-page",\n' +
|
|
1775
|
+
' role: "reviewer",\n' +
|
|
1776
|
+
' subscribe: ["review.login-page"],\n' +
|
|
1777
|
+
' allowPublish: ["review.login-page"],\n' +
|
|
1778
|
+
' prompt: "You review the login page change in PR 812. The brief is on #review.login-page. Check the session timeout and the error messages against docs/auth.md. Post each finding there with its file and line. When you are done, post a one-line verdict and despawn yourself."\n' +
|
|
1779
|
+
"}\n" +
|
|
1780
|
+
"```",
|
|
1714
1781
|
schema: {
|
|
1715
1782
|
name: z
|
|
1716
1783
|
.string()
|