@productbrain/mcp 0.0.1-beta.9532 → 0.0.1-beta.9534

package/dist/{chunk-HHH3YC56.js → chunk-APQ2MKVQ.js}

@@ -43,7 +43,7 @@ import {
   trackQualityVerdict,
   trackSessionCaptureRate,
   trackZeroCaptureAuditFired
-} from "./chunk-GXPFXLOF.js";
+} from "./chunk-HOSGKIO6.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -12223,21 +12223,28 @@ function formatSeatSentence(action, reply, clean) {
   }
   return reply.removed ? `Unseated ${who} from ${roleLabel2} in ${teamLabel}.` : `${who} did not hold ${roleLabel2} in ${teamLabel}; nothing changed.`;
 }
+function formatInviteSentence(reply, clean) {
+  const who = `${clean(reply.person)} [${reply.personId}]`;
+  return reply.inPlace ? `Invited ${who} at ${clean(reply.email)}; they keep every role they already hold.` : `Invited ${who} at ${clean(reply.email)} as a new person.`;
+}
 
 // src/tools/role.ts
-var ROLE_ACTIONS = ["accountable", "seat", "unseat"];
+var ROLE_ACTIONS = ["accountable", "seat", "unseat", "invite"];
 var roleSchema = z31.object({
   action: z31.enum(ROLE_ACTIONS).describe(
-    "'accountable': what this role owns (explicit), reports on (reporting), and \u2014 not yet computed \u2014 inherits via Team-Lead vacancy coverage. 'seat': put a person in this role. 'unseat': take this role from a person."
+    "'accountable': what this role owns (explicit), reports on (reporting), and \u2014 not yet computed \u2014 inherits via Team-Lead vacancy coverage. 'seat': put a person in this role. 'unseat': take this role from a person. 'invite': send a login link by email; a placeholder person (seated by name) is invited in place and keeps every role it holds."
   ),
-  roleId: z31.string().max(200).optional().describe("The role, by the human chain id `chain.getEntry` or `pb get` would print for it, or a raw entry id. Required for every action."),
+  roleId: z31.string().max(200).optional().describe("The role, by the human chain id `chain.getEntry` or `pb get` would print for it, or a raw entry id. Required for every action except 'invite'."),
   canonicalKey: z31.string().max(200).optional().describe("'accountable': narrow to one kind (e.g. objective, key_result, tension)."),
   limit: z31.number().int().positive().max(200).optional().describe("'accountable': max explicit-list rows per page (default and maximum 200)."),
   cursor: z31.number().optional().describe("'accountable': continue the explicit list from an earlier truncated page's nextCursor."),
-  person: z31.string().max(200).optional().describe("'seat' / 'unseat': an existing person, by person id or exact email. For 'seat', give this or newPersonName, not both."),
+  person: z31.string().max(200).optional().describe(
+    "'seat' / 'unseat': an existing person, by person id or exact email. For 'seat', give this or newPersonName, not both. 'invite': the placeholder's person id."
+  ),
   newPersonName: z31.string().max(120).optional().describe(
-    "'seat': the name of a person who has no login yet; a placeholder person is created once and reused for the same exact name. Refused when the name belongs to someone with an account."
+    "'seat': the name of a person who has no login yet; a placeholder person is created once and reused for the same exact name. Refused when the name belongs to someone with an account. 'invite': the name of a new person to invite, instead of person."
   ),
+  email: z31.string().max(320).optional().describe("'invite': where the login link goes. Required for 'invite'."),
   teamId: z31.string().max(200).optional().describe(
     "'seat' / 'unseat': the team, by chain id or entry id. Only needed for Team Lead, which lives in every team; any other role is seated in its home team."
   )
@@ -12262,11 +12269,18 @@ var unseatVariant = z31.object({
   person: z31.string().max(200),
   teamId: z31.string().max(200).optional()
 });
-var roleActionUnion = z31.discriminatedUnion("action", [accountableVariant, seatVariant, unseatVariant]);
+var inviteVariant = z31.object({
+  action: z31.literal("invite"),
+  email: z31.string().max(320),
+  person: z31.string().max(200).optional(),
+  newPersonName: z31.string().max(120).optional()
+});
+var roleActionUnion = z31.discriminatedUnion("action", [accountableVariant, seatVariant, unseatVariant, inviteVariant]);
 var ROLE_ACTION_SPECS = {
   accountable: { params: ["roleId", "canonicalKey", "limit", "cursor"], description: "roleId is required; canonicalKey/limit/cursor are optional." },
   seat: { params: ["roleId", "person", "newPersonName", "teamId"], description: "roleId is required, plus exactly one of person or newPersonName; teamId only for Team Lead." },
-  unseat: { params: ["roleId", "person", "teamId"], description: "roleId and person are required; teamId only for Team Lead." }
+  unseat: { params: ["roleId", "person", "teamId"], description: "roleId and person are required; teamId only for Team Lead." },
+  invite: { params: ["email", "person", "newPersonName"], description: "email is required, plus exactly one of person (a placeholder's id) or newPersonName." }
 };
 function formatHolders(result2) {
   if (result2.holders.length === 0) return [`  holders: none${result2.holdersTruncated ? " found, but the membership scan is incomplete" : ""}`];
@@ -12346,6 +12360,22 @@ function handleRoleSeat(roleId, person, newPersonName, teamId) {
 function handleRoleUnseat(roleId, person, teamId) {
   return runSeatAction("unseat", "organisation.unseatFromRole", { roleId, person, teamId });
 }
+async function handleRoleInvite(email, person, newPersonName) {
+  const params = { email, person, newPersonName };
+  try {
+    requireWriteAccess();
+    const result2 = await kernelMutation("people.invite", {
+      email,
+      targetPersonId: person,
+      displayName: newPersonName,
+      sessionId: getAgentSessionId()
+    });
+    const message = formatInviteSentence(result2, sanitizeSingleLineField);
+    return successResult(message, message, result2);
+  } catch (err) {
+    return roleErrorResult(err, "invite", params);
+  }
+}
 function roleErrorResult(err, action, params = {}) {
   const classified = classifyError(err);
   const definedParams = Object.fromEntries(Object.entries(params).filter(([, v]) => v !== void 0));
@@ -12363,13 +12393,14 @@ function registerRoleTools(server) {
   const roleHandlers = {
     accountable: (data) => handleRoleAccountable(data.roleId, data.canonicalKey, data.limit, data.cursor),
     seat: (data) => handleRoleSeat(data.roleId, data.person, data.newPersonName, data.teamId),
-    unseat: (data) => handleRoleUnseat(data.roleId, data.person, data.teamId)
+    unseat: (data) => handleRoleUnseat(data.roleId, data.person, data.teamId),
+    invite: (data) => handleRoleInvite(data.email, data.person, data.newPersonName)
   };
   server.registerTool(
     "role",
     {
       title: "Role",
-      description: "Workspace roles \u2014 who is accountable for what, and who holds it. Three actions:\n\n- **accountable**: what this role owns (`explicit` \u2014 the canonical ownership row for objective/key_result/tension, data.ownerRoleId for domain), reports on (`reporting`, data.reporterRoleId \u2014 key results and tensions only, a separate fact from ownership), and \u2014 always `not-computed` today, never faked as empty \u2014 inherits via Team-Lead vacancy coverage. Also lists `holders`.\n- **seat**: put a person in this role, by person id or email, or by `newPersonName` for someone with no login yet (a placeholder person, created once per exact name). The role's home team is used; name `teamId` only for Team Lead. A held role refuses a second holder and names the holder; the person keeps their other roles in the team. Needs the team's Team Lead.\n- **unseat**: take this role from a person; their other roles in the team stay. The last active Team Lead of a team is refused.",
+      description: "Workspace roles \u2014 who is accountable for what, and who holds it. Four actions:\n\n- **accountable**: what this role owns (`explicit` \u2014 the canonical ownership row for objective/key_result/tension, data.ownerRoleId for domain), reports on (`reporting`, data.reporterRoleId \u2014 key results and tensions only, a separate fact from ownership), and \u2014 always `not-computed` today, never faked as empty \u2014 inherits via Team-Lead vacancy coverage. Also lists `holders`.\n- **seat**: put a person in this role, by person id or email, or by `newPersonName` for someone with no login yet (a placeholder person, created once per exact name). The role's home team is used; name `teamId` only for Team Lead. A held role refuses a second holder and names the holder; the person keeps their other roles in the team. Needs the team's Team Lead.\n- **unseat**: take this role from a person; their other roles in the team stay. The last active Team Lead of a team is refused.\n- **invite**: send a login link to `email`. Give `person` (a placeholder's id, as `seat` printed it) to invite that person in place: they keep every role they hold. Or give `newPersonName` to invite someone new. A person who already has a login or an invite is refused. Needs a workspace owner or admin.",
       inputSchema: roleSchema,
       // The hints describe the whole tool, so they say the most it can do: unseat removes a role and can
       // delete a membership row (destructive), and a repeated seat still writes history and audit rows
@@ -12731,7 +12762,7 @@ var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
 | \`feedback\` | Submit product feedback (any key, no session required); \`list\` reads back your own workspace's feedback (no gate); vendor triage: queue / note / group / status | \`action\`: submit, list, queue, note, group, status |
 | \`shape\` | Review / disposition write-shape (single-concern split) advisories | \`action\`: list, show, agree, dismiss |
 | \`question\` | Routed questions \u2014 create, reassign, answer, force-close, list | \`action\`: create, assign, answer, force-close, list |
-| \`role\` | What a role is accountable for and who holds it; seat a person in a role (by id, email or a new name) or unseat them | \`action\`: accountable, seat, unseat |
+| \`role\` | What a role owns and who holds it; seat (by id, email or new name), unseat, or invite a placeholder in place | \`action\`: accountable, seat, unseat, invite |
 | \`outcome\` | Record an outcome measurement and read the ones already recorded | \`action\`: record, list, show |
 
 This table lists actions only. See \`tools/list\` for each tool's input schema; a missing or invalid parameter is named in the call's own reply.
@@ -13503,4 +13534,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-HHH3YC56.js.map
+//# sourceMappingURL=chunk-APQ2MKVQ.js.map