@volter/supercode-orchestrator 0.5.68 → 0.5.69

package/bin/agent-channel.mjs

@@ -11,8 +11,10 @@
 // and every answer is posted back anchored at its thread's root, by `AgentMailboxBridge` over the RH2 adapter.
 //
 // The Room is found by its key (`--room-key`, default `account-<agent>`), or opened once when the organization has
-// none: the principal (`--principal`, RH2's principal id) as its operator, and the bot seated in its conversation
-// answering every line. `--room <id>` names an existing Room instead and opens nothing.
+// none: from the organization's preset (`--preset`) with the principal (`--principal`, RH2's principal id) and the agent
+// both seated in the role the org's floor names (`--role`), and the agent answering every line of its conversation.
+// Authority comes from a stated role: opening a Room without both is refused. `--room <id>` names an existing Room
+// instead and opens nothing.
 //
 // RH2 is reached as the agent's own principal where the organization declares the agent (docs/adr/0017: `supercode
 // orchestrator apps install rh2-agent … --profile <agent>` in the home, `--root` or HERMES_HOME), so its threads, its DM
@@ -37,10 +39,10 @@ import { installedApps } from '../installed-apps.mjs';
 
 const { values } = parseArgs({
   args: process.argv.slice(3),
-  options: { agent: { type: 'string' }, root: { type: 'string' }, room: { type: 'string' }, 'room-key': { type: 'string' }, 'room-name': { type: 'string' }, principal: { type: 'string' }, state: { type: 'string' }, platform: { type: 'string' }, site: { type: 'string' }, jql: { type: 'string' }, 'slack-channel': { type: 'string' }, help: { type: 'boolean' } },
+  options: { agent: { type: 'string' }, root: { type: 'string' }, room: { type: 'string' }, 'room-key': { type: 'string' }, 'room-name': { type: 'string' }, principal: { type: 'string' }, preset: { type: 'string' }, role: { type: 'string' }, state: { type: 'string' }, platform: { type: 'string' }, site: { type: 'string' }, jql: { type: 'string' }, 'slack-channel': { type: 'string' }, help: { type: 'boolean' } },
 });
 if (values.help || !values.agent) {
-  console.log('supercode-orchestrator agent-channel --agent <name> [--root <home>] [--room <id> | --room-key <key> --principal <rh2 principal id> [--room-name <name>]] [--state <file>]\n       supercode-orchestrator agent-channel --agent <name> --platform slack --slack-channel <id>[,<id>] [--state <file>]\n       supercode-orchestrator agent-channel --agent <name> --platform jira --site <url> --jql <jql> [--state <file>]');
+  console.log('supercode-orchestrator agent-channel --agent <name> [--root <home>] [--room <id> | --room-key <key> [--principal <rh2 principal id> --preset <preset id> --role <role key> [--room-name <name>]]] [--state <file>]\n       supercode-orchestrator agent-channel --agent <name> --platform slack --slack-channel <id>[,<id>] [--state <file>]\n       supercode-orchestrator agent-channel --agent <name> --platform jira --site <url> --jql <jql> [--state <file>]');
   process.exit(values.help ? 0 : 2);
 }
 const log = (level, line) => (level === 'debug' ? undefined : console.error(`${new Date().toISOString()} ${level} ${line}`));
@@ -99,10 +101,15 @@ async function accountRoom() {
   const found = (Array.isArray(listing) ? listing : listing.rooms ?? []).map((entry) => entry.room ?? entry).find((room) => room?.key === key && room.state === 'active');
   if (found) return String(found.roomId);
   if (!values.principal) throw new Error(`no active Room with key ${key}, and no --principal to open it for`);
+  // the Room's shape and the seats' role are the organization's (its floor names them), never this door's
+  const missing = ['preset', 'role'].filter((name) => !values[name]);
+  if (missing.length) throw new Error(`no active Room with key ${key}; opening one needs ${missing.map((name) => `--${name}`).join(' and ')} from the organization's floor (the preset the Room is made from and the role its principal and agent hold)`);
+  const seated = [...new Set([values.principal, adapter.principalId()])];
   const { room } = await post('/rooms', {
     key,
+    presetId: values.preset,
     name: values['room-name'] ?? `${values.agent}`,
-    members: [{ principalId: values.principal, roleKeys: ['operator'] }],
+    members: seated.map((principalId) => ({ principalId, roleKeys: [values.role] })),
   });
   const view = await adapter.get(`/rooms/${encodeURIComponent(room.roomId)}`);
   const conversation = view.room?.defaultConversationId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-orchestrator",
-  "version": "0.5.68",
+  "version": "0.5.69",
   "type": "module",
   "description": "The orchestrator runtime over the Volter Harness ontology: one typed operational model whose folder is its serialization, read and written through the harness orchestration doors (docs/ORCHESTRATOR-IR.md)",
   "exports": {