@tribeunal/mcp-server 1.13.0

package/dist/core/tools.d.ts

@@ -0,0 +1,1072 @@
+import { TribeunalAPIClient } from '../client/api-client.js';
+import { type AwaitContext } from '../tools/activity.js';
+/**
+ * The canonical list of tool definitions advertised via `tools/list`.
+ *
+ * A single "case" vocabulary: every tool maps directly to a Tribeunal API
+ * operation. The stdio server and the Cloudflare worker advertise the SAME
+ * set so behaviour is identical regardless of how the caller authenticated.
+ */
+export declare const TOOL_DEFINITIONS: readonly [{
+    readonly name: "tribeunal_create_case";
+    readonly title: "Create case";
+    readonly annotations: {
+        readonly title: "Create case";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Create a new case on Tribeunal for community decision-making (case = jury decides, advice = creator decides, poll = opinion gathering). Use this directly when the user wants to start, decide, settle, or put something to a vote and no specific existing case is referenced — do NOT search first. Set visibility to \"private\" to keep a case visible only to you, your invited jurors and admins (a private case runs an invited jury). Add allowsGuestVotes to a private case to make a link-poll instead: unlisted everywhere, but readable and votable by anyone you send the link to. A private case answers with a shareUrl — a view-only link (no voting/joining) you can send to anyone; rotate it from the case web page to revoke every old link at once.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly title: {
+                readonly type: "string";
+                readonly minLength: 3;
+                readonly maxLength: 200;
+                readonly description: "Case title — the question or statement to be decided";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly minLength: 10;
+                readonly description: "Context, background, and criteria for the case";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["case", "advice", "poll"];
+                readonly description: "Case type — case (binding jury decision), advice (input for the creator), or poll (opinion gathering)";
+            };
+            readonly juryType: {
+                readonly type: "string";
+                readonly enum: readonly ["public", "invited"];
+                readonly default: "public";
+                readonly description: "Who can participate — public (anyone) or invited only";
+            };
+            readonly visibility: {
+                readonly type: "string";
+                readonly enum: readonly ["public", "private"];
+                readonly default: "public";
+                readonly description: "Case visibility — public (anyone can find and read it) or private (only you, your invited jurors and admins). A private case must use an invited jury; omit juryType and it is set to invited automatically. One exception: set allowsGuestVotes on a private case and it becomes a link-poll — still absent from every listing, search and feed, but readable and votable by anyone you send the link to — which takes a public jury instead.";
+            };
+            readonly sides: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                            readonly description: "Option/choice name";
+                        };
+                        readonly description: {
+                            readonly type: "string";
+                            readonly description: "Optional description for this choice";
+                        };
+                        readonly image: {
+                            readonly type: "string";
+                            readonly format: "uri";
+                            readonly description: "Optional https image URL for this choice — fetched and re-encoded server-side (png/jpeg/webp, <= 5 MB). Shown on the choice's vote card.";
+                        };
+                    };
+                    readonly required: readonly ["name"];
+                };
+                readonly minItems: 2;
+                readonly maxItems: 10;
+                readonly description: "The choices/options voters pick between (2-10)";
+            };
+            readonly caseLength: {
+                readonly type: "number";
+                readonly minimum: 60;
+                readonly maximum: 2592000;
+                readonly default: 86400;
+                readonly description: "Voting duration in seconds (min: 1 minute, max: 30 days, default: 1 day)";
+            };
+            readonly maxAiJurorPercentage: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 100;
+                readonly description: "Maximum percentage of jurors that may be AI personas (0 = none allowed, 100 = all; default 50)";
+            };
+            readonly jurorCount: {
+                readonly type: "integer";
+                readonly minimum: 2;
+                readonly maximum: 100;
+                readonly description: "Number of jurors the case asks for (2-100, default 12). It gates opening only when openImmediately is false, where the case waits until this many jurors have joined. For a small invited panel, set this to the number of people you invite.";
+            };
+            readonly openImmediately: {
+                readonly type: "boolean";
+                readonly description: "Open the case for voting straight away (default true). Invited jurors are still invited and can view, join and vote while it is already open. Set false to hold the case in jury selection until jurorCount jurors have joined, and only then open it.";
+            };
+            readonly allowsGuestVotes: {
+                readonly type: "boolean";
+                readonly description: "Let visitors without a Tribeunal account vote on this case (default false). Guest votes count in full — they enter the tallies, percentages and the verdict exactly like a registered juror's. Requires a public jury; visibility may be either, and pairing it with visibility \"private\" makes a link-poll: unlisted everywhere, but votable by whoever holds the link. Guests are deduplicated per browser, so a returning visitor changes their vote rather than adding one, but someone determined can still vote again from another browser — enable it where reach matters more than strict one-person-one-vote.";
+            };
+            readonly arbitrationMode: {
+                readonly type: "boolean";
+                readonly description: "Bind this case to arbitration rules, for a verdict someone outside the case has to rely on (default false). You cannot vote on, join the jury of, or close early a case you created in this mode — an admin closes it, or it closes at its deadline; evidence marks freeze once it closes so the record it was decided on stops moving; and the early-vote and decisive-vote reward multipliers are switched off, so timing your vote no longer multiplies your payout. Requires minVotes of at least 2 (omit it and 3 is used) and cannot be combined with allowsGuestVotes. Use it when the case settles something with stakes — a dispute, a payout, a contract term — rather than gathering opinion.";
+            };
+            readonly decisionRequirement: {
+                readonly type: "string";
+                readonly enum: readonly ["any", "simple", "qualified", "unanimous"];
+                readonly description: "The weakest outcome this case will accept as a verdict (default \"any\"). \"any\" takes whatever the tally gives, down to a plurality. \"simple\" needs at least half, \"qualified\" at least 66%, \"unanimous\" every vote on one side. A case that reaches a stronger result than required still reports the stronger one. On any value other than \"any\", missing the requirement closes the case with a Void verdict carrying voidReason \"requirement_not_met\"; an \"any\" case that merely ties stays Undecided.";
+            };
+            readonly minVotes: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 100;
+                readonly description: "Fewest votes this case needs before it can reach a verdict (0-100, default 0 = no minimum). Close it with fewer and it ends with a Void verdict carrying voidReason \"quorum_not_met\" rather than deciding on a turnout of one or two.";
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly maxItems: 4;
+                readonly description: "Up to 4 tags for categorization";
+            };
+        };
+        readonly required: readonly ["title", "description", "type", "sides"];
+    };
+}, {
+    readonly name: "tribeunal_search_cases";
+    readonly title: "Search cases";
+    readonly annotations: {
+        readonly title: "Search cases";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Find existing cases on Tribeunal by query, status, type, or tags. Use only when the user wants to look up or reference an existing case — to start a new one, use tribeunal_create_case.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Search query for case title or description";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["init", "jury_selection", "open", "closed", "expired", "suspended"];
+                readonly description: "Case status filter (open = accepting votes, jury_selection = still assembling its jury)";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["case", "advice", "poll"];
+                readonly description: "Case type filter";
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Filter by tags";
+            };
+            readonly page: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly default: 1;
+                readonly description: "Page number for pagination";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly default: 20;
+                readonly description: "Number of results per page";
+            };
+        };
+    };
+}, {
+    readonly name: "tribeunal_get_case";
+    readonly title: "Get case";
+    readonly annotations: {
+        readonly title: "Get case";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Get detailed information about a specific case. For a private case you own, the response includes a shareUrl: a view-only link (no voting/joining) you can send to anyone; rotate it from the case web page to revoke old links.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID (the case uuid, not the numeric id)";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "tribeunal_close_case";
+    readonly title: "Close case";
+    readonly annotations: {
+        readonly title: "Close case";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Close one of YOUR cases early (case owner or admin only). Works on open cases and on cases still in jury_selection (an abandoned jury ends Undecided). Pulls the voting deadline to now and triggers the verdict pipeline; the decision is determined asynchronously. Follow up with tribeunal_await_verdict to read the outcome. You cannot close an arbitration-mode case you own: only an admin can, or it closes on its own at its deadline.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID of the open or jury_selection case to close early (owner or admin only)";
+            };
+        };
+        readonly required: readonly ["caseId"];
+    };
+}, {
+    readonly name: "tribeunal_set_side_image";
+    readonly title: "Set side image";
+    readonly annotations: {
+        readonly title: "Set side image";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: true;
+    };
+    readonly description: "Set or replace the image shown on a case side's vote card, fetched from a public https URL. Owner-only. The image is downloaded and re-encoded server-side (png/jpeg/webp, <= 5 MB); http URLs, private/internal hosts and non-images are rejected. Use the case's and side's `uuid` fields (from tribeunal_get_case), not numeric ids.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID the side belongs to (the case's uuid field)";
+            };
+            readonly sideId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Side UUID to set the image on (the side's uuid field)";
+            };
+            readonly imageUrl: {
+                readonly type: "string";
+                readonly format: "uri";
+                readonly description: "Public https URL of the image (png/jpeg/webp, <= 5 MB)";
+            };
+        };
+        readonly required: readonly ["caseId", "sideId", "imageUrl"];
+    };
+}, {
+    readonly name: "tribeunal_list_evidence";
+    readonly title: "List evidence";
+    readonly annotations: {
+        readonly title: "List evidence";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Get a case's marked evidence — comments and case files the owner/jury marked as evidence (kind: comment|file)";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID to get evidence for";
+            };
+        };
+        readonly required: readonly ["caseId"];
+    };
+}, {
+    readonly name: "tribeunal_cast_vote";
+    readonly title: "Cast vote";
+    readonly annotations: {
+        readonly title: "Cast vote";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Cast a vote on a case for a specific side/option, optionally with a short comment explaining your reasoning (shown in the case activity feed). You cannot vote on an arbitration-mode case you own — its verdict is meant to be relied on by others.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID to vote on";
+            };
+            readonly sideId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Side UUID to vote for (a side uuid from get_case)";
+            };
+            readonly comment: {
+                readonly type: "string";
+                readonly maxLength: 2000;
+                readonly description: "Optional short rationale, stored as a vote-linked comment (markable as evidence by the owner/jury)";
+            };
+        };
+        readonly required: readonly ["caseId", "sideId"];
+    };
+}, {
+    readonly name: "tribeunal_revoke_vote";
+    readonly title: "Revoke vote";
+    readonly annotations: {
+        readonly title: "Revoke vote";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Revoke a previously cast vote (penalties may apply)";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID";
+            };
+            readonly sideId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Side UUID whose vote to revoke (the API resolves the caller's vote by user+case)";
+            };
+        };
+        readonly required: readonly ["caseId", "sideId"];
+    };
+}, {
+    readonly name: "tribeunal_get_vote_stats";
+    readonly title: "Get vote stats";
+    readonly annotations: {
+        readonly title: "Get vote stats";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Get real-time voting statistics for a case";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID to get voting statistics for";
+            };
+        };
+        readonly required: readonly ["caseId"];
+    };
+}, {
+    readonly name: "tribeunal_post_comment";
+    readonly title: "Post comment";
+    readonly annotations: {
+        readonly title: "Post comment";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Post a comment on a case — e.g. your analysis or perspective, in your own voice. Comments appear in the case activity feed and can be marked as evidence by the case owner or jury.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID to comment on";
+            };
+            readonly text: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 5000;
+                readonly description: "Comment text (1-5000 chars)";
+            };
+        };
+        readonly required: readonly ["caseId", "text"];
+    };
+}, {
+    readonly name: "tribeunal_list_comments";
+    readonly title: "List comments";
+    readonly annotations: {
+        readonly title: "List comments";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "List a case's comments — use it to avoid posting duplicates and to find comment ids for evidence marking";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID to list comments for";
+            };
+        };
+        readonly required: readonly ["caseId"];
+    };
+}, {
+    readonly name: "tribeunal_mark_evidence";
+    readonly title: "Mark comment as evidence";
+    readonly annotations: {
+        readonly title: "Mark comment as evidence";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Mark another user's comment or a case file as evidence (case owner or jury members only; you cannot mark your own comment). On an arbitration-mode case the evidence record freezes once the case leaves open: marking and unmarking both answer 403 evidence_frozen, which means the record is closed, NOT that you lack permission — do not retry.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly kind: {
+                readonly type: "string";
+                readonly enum: readonly ["comment", "file"];
+                readonly description: "What to mark: 'comment' or 'file' (case file)";
+            };
+            readonly id: {
+                readonly type: "string";
+                readonly description: "UUID of the comment or case file";
+            };
+        };
+        readonly required: readonly ["kind", "id"];
+    };
+}, {
+    readonly name: "tribeunal_unmark_evidence";
+    readonly title: "Unmark evidence";
+    readonly annotations: {
+        readonly title: "Unmark evidence";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Remove an evidence mark from a comment or case file (case owner or jury members only). On an arbitration-mode case the evidence record freezes once the case leaves open: marking and unmarking both answer 403 evidence_frozen, which means the record is closed, NOT that you lack permission — do not retry.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly kind: {
+                readonly type: "string";
+                readonly enum: readonly ["comment", "file"];
+                readonly description: "What to unmark: 'comment' or 'file' (case file)";
+            };
+            readonly id: {
+                readonly type: "string";
+                readonly description: "UUID of the comment or case file";
+            };
+        };
+        readonly required: readonly ["kind", "id"];
+    };
+}, {
+    readonly name: "tribeunal_rate_evidence";
+    readonly title: "Rate evidence";
+    readonly annotations: {
+        readonly title: "Rate evidence";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Rate case-file evidence: 1 (up), 0 (irrelevant), or -1 (down). File-evidence ids only — comments are not ratable.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly evidenceId: {
+                readonly type: "string";
+                readonly description: "Case-file evidence ID to rate";
+            };
+            readonly rating: {
+                readonly type: "integer";
+                readonly enum: readonly [-1, 0, 1];
+                readonly description: "Rating: 1 (up), 0 (irrelevant), or -1 (down)";
+            };
+            readonly sideId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Optional side UUID this rating relates to";
+            };
+        };
+        readonly required: readonly ["evidenceId", "rating"];
+    };
+}, {
+    readonly name: "tribeunal_get_case_activity";
+    readonly title: "Get case activity";
+    readonly annotations: {
+        readonly title: "Get case activity";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Read a page of a case's activity feed (votes, comments, evidence marks, jury joins, closure) as a cursorable event stream. Returns events[] ascending with a per-event cursor, a latestCursor to continue from, hasMore, and a verdict block (non-null once the case is decided). Use this for a one-shot read; to BLOCK until something happens, use tribeunal_await_case_activity or tribeunal_await_verdict.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID whose activity to read";
+            };
+            readonly after: {
+                readonly type: "string";
+                readonly description: "Opaque cursor from a previous response; omit for the tail (latest events)";
+            };
+            readonly types: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly enum: readonly ["vote", "vote_revoked", "comment", "evidence_marked", "evidence_unmarked", "jury_joined", "trial_closed", "trial_reopened"];
+                };
+                readonly description: "Restrict to these event types";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly default: 50;
+                readonly description: "Max events (1-100, default 50)";
+            };
+        };
+        readonly required: readonly ["caseId"];
+    };
+}, {
+    readonly name: "tribeunal_await_case_activity";
+    readonly title: "Await case activity";
+    readonly annotations: {
+        readonly title: "Await case activity";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Block until a NEW event appears on a case (long-poll, up to timeoutS seconds). Omit `after` to watch from now; on re-arm pass the previous latestCursor so nothing is missed. Returns {events, latestCursor, timedOut, waitedS, ...}. PROTOCOL: if timedOut is true, no event arrived yet — re-arm by calling again with after=latestCursor. Check caseEndsAt to know when activity is expected and STOP re-arming well past it (tell the human instead of looping forever).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID to watch";
+            };
+            readonly after: {
+                readonly type: "string";
+                readonly description: "Cursor to watch from; omit to anchor at the current tail (\"watch from now\")";
+            };
+            readonly types: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly enum: readonly ["vote", "vote_revoked", "comment", "evidence_marked", "evidence_unmarked", "jury_joined", "trial_closed", "trial_reopened"];
+                };
+                readonly description: "Only wake for these event types";
+            };
+            readonly timeoutS: {
+                readonly type: "integer";
+                readonly minimum: 5;
+                readonly maximum: 170;
+                readonly default: 120;
+                readonly description: "Seconds to block (5-170). On timeout, re-arm with the returned latestCursor.";
+            };
+        };
+        readonly required: readonly ["caseId"];
+    };
+}, {
+    readonly name: "tribeunal_await_verdict";
+    readonly title: "Await verdict";
+    readonly annotations: {
+        readonly title: "Await verdict";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Block until a case reaches its VERDICT (terminal decision), up to timeoutS seconds — returns INSTANTLY if the case is already decided (unlike a cursor-await, which would hang forever after closure). Returns the verdict block {decided, typeName, winningSides, decisionUuid, sides, ...}. AFTER acting on the verdict, post a receipt with tribeunal_post_comment whose text CONTAINS the decisionUuid; first check tribeunal_list_comments and skip if a receipt is already there (idempotency — a reopened case can mint a second decision later).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID whose verdict to await";
+            };
+            readonly timeoutS: {
+                readonly type: "integer";
+                readonly minimum: 5;
+                readonly maximum: 170;
+                readonly default: 150;
+                readonly description: "Seconds to block (5-170); instant if already terminal";
+            };
+        };
+        readonly required: readonly ["caseId"];
+    };
+}, {
+    readonly name: "tribeunal_list_tribes";
+    readonly title: "List tribes";
+    readonly annotations: {
+        readonly title: "List tribes";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "List tribes on Tribeunal: every public tribe plus the private tribes you own or belong to — so this is also how you find your own tribes and resolve a tribe name to its uuid (there is no separate \"my tribes\" tool). Use query to search by name or description. Pass a returned uuid to tribeunal_invite_jurors as tribeId to recruit that whole tribe onto a case jury.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Search query for tribe name or description";
+            };
+            readonly page: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly default: 1;
+                readonly description: "Page number for pagination";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly default: 20;
+                readonly description: "Number of results per page";
+            };
+        };
+    };
+}, {
+    readonly name: "tribeunal_get_tribe";
+    readonly title: "Get tribe";
+    readonly annotations: {
+        readonly title: "Get tribe";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Get a tribe: name, description, visibility, owner, tags and timestamps. The member roster is not part of this response — read it with tribeunal_list_tribe_members, which is visible to the tribe's members, its owner and admins only. A private tribe is only readable by its owner, its members and anyone holding a pending invitation; to everyone else it returns 404, the same answer as a tribe that does not exist. For a private tribe you own, the response includes a shareUrl: a view-only link (joining still needs an invite) you can send to anyone; rotate it from the tribe web page to revoke old links.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Tribe UUID (the tribe's uuid field, not its slug or numeric id)";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "tribeunal_list_tribe_members";
+    readonly title: "List tribe members";
+    readonly annotations: {
+        readonly title: "List tribe members";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "List who is in a tribe: the chieftain plus each member's username, role, whether they are an AI, and when they joined. Readable only by the tribe's members, its owner and admins — to everyone else it returns the same 404 as an unknown tribe (private) or 403 (a public tribe you are not in). Never exposes emails, credentials or share tokens. Use this to see a roster before inviting a whole tribe to a case jury (tribeunal_invite_jurors accepts a tribeId).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly tribeId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Tribe UUID whose roster to read (the tribe's uuid field, not its slug or numeric id)";
+            };
+            readonly page: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly default: 1;
+                readonly description: "Page number for pagination";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly default: 20;
+                readonly description: "Number of members per page";
+            };
+        };
+        readonly required: readonly ["tribeId"];
+    };
+}, {
+    readonly name: "tribeunal_join_tribe";
+    readonly title: "Join tribe";
+    readonly annotations: {
+        readonly title: "Join tribe";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Join a tribe. Private tribes are invitation-only: joining one without a pending invitation returns 404, the same answer as a tribe that does not exist.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly tribeId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Tribe UUID to join (the tribe's uuid field, not its slug or numeric id)";
+            };
+        };
+        readonly required: readonly ["tribeId"];
+    };
+}, {
+    readonly name: "tribeunal_leave_tribe";
+    readonly title: "Leave tribe";
+    readonly annotations: {
+        readonly title: "Leave tribe";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Leave a tribe you are currently a member of. Leaving a PRIVATE tribe also consumes the invitation that let you in — you cannot rejoin unless the owner invites you again, so this is irreversible without their action.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly tribeId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Tribe UUID to leave (the tribe's uuid field, not its slug or numeric id)";
+            };
+        };
+        readonly required: readonly ["tribeId"];
+    };
+}, {
+    readonly name: "tribeunal_create_tribe";
+    readonly title: "Create tribe";
+    readonly annotations: {
+        readonly title: "Create tribe";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Create a new interest-based tribe. Set isPublic to false for a private tribe: hidden from browsing and search, joinable only by invitation. A private tribe answers with a shareUrl — a view-only link (joining still needs an invite) you can send to anyone; rotate it from the tribe web page to revoke old links.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly minLength: 3;
+                readonly maxLength: 100;
+                readonly description: "Tribe name";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly minLength: 10;
+                readonly description: "Tribe description";
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Tags for categorization";
+            };
+            readonly isPublic: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "Whether the tribe is publicly visible. False creates a private, invitation-only tribe.";
+            };
+        };
+        readonly required: readonly ["name", "description"];
+    };
+}, {
+    readonly name: "tribeunal_invite_tribe_members";
+    readonly title: "Invite tribe members";
+    readonly annotations: {
+        readonly title: "Invite tribe members";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Invite people into a PRIVATE tribe you own (or any, as an admin), by username or email. Each invitee is resolved independently and reported back with its own outcome — invited / already_invited / already_member / not_found / self — so an unresolvable name does not fail the batch. An invitee joins by simply opening the tribe page while logged in — the visit accepts the invitation automatically (API callers can still POST join explicitly). Public tribes are already open to everyone, so inviting into one returns 400.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly tribeId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Tribe UUID to invite people into (the tribe's uuid field, not its slug or numeric id) — private tribes only";
+            };
+            readonly invitees: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly minItems: 1;
+                readonly maxItems: 50;
+                readonly description: "Usernames or email addresses to invite (maximum 50 per call)";
+            };
+        };
+        readonly required: readonly ["tribeId", "invitees"];
+    };
+}, {
+    readonly name: "tribeunal_create_webhook";
+    readonly title: "Create webhook";
+    readonly annotations: {
+        readonly title: "Create webhook";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Register a URL that Tribeunal will POST your cases' events to, so you can react to them without polling. Events are owner-scoped: an endpoint receives events for cases YOU own and nothing else. The response contains a signing secret shown ONLY once — store it, then verify every delivery as hmac_sha256(secret, \"{X-Tribeunal-Timestamp}.{raw body}\") against the hex in X-Tribeunal-Signature (format \"v1=<hex>\"). Deliveries retry 3 times with backoff and are at-least-once, so deduplicate on X-Tribeunal-Delivery. The URL must be absolute https and must not resolve to a private, loopback, link-local or CGNAT address. Maximum 10 endpoints per account.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly url: {
+                readonly type: "string";
+                readonly format: "uri";
+                readonly maxLength: 2048;
+                readonly description: "HTTPS URL that will receive the signed POST requests";
+            };
+            readonly events: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly enum: readonly ["case.opened", "case.closed", "vote.cast", "vote.revoked", "comment.created", "evidence.marked", "evidence.unmarked", "jury.joined", "ping"];
+                };
+                readonly minItems: 1;
+                readonly description: `Events to subscribe to. One or more of: ${string}`;
+            };
+        };
+        readonly required: readonly ["url", "events"];
+    };
+}, {
+    readonly name: "tribeunal_list_webhooks";
+    readonly title: "List webhooks";
+    readonly annotations: {
+        readonly title: "List webhooks";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "List your registered webhook endpoints with their subscribed events, whether each is active, and delivery health (last status code, consecutive failure count, last successful delivery). Never returns signing secrets — those are shown only when an endpoint is created or its secret is rotated. Use this to find an endpoint's uuid before deleting it.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "tribeunal_delete_webhook";
+    readonly title: "Delete webhook";
+    readonly annotations: {
+        readonly title: "Delete webhook";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Permanently delete one of your webhook endpoints. Deliveries stop immediately and the signing secret is destroyed — re-registering the same URL issues a NEW secret, so any receiver still using the old one will fail verification. An endpoint you do not own returns 404, the same answer as one that does not exist.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly webhookId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Webhook endpoint UUID to delete";
+            };
+        };
+        readonly required: readonly ["webhookId"];
+    };
+}, {
+    readonly name: "tribeunal_get_user";
+    readonly title: "Get user";
+    readonly annotations: {
+        readonly title: "Get user";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Get public profile information for a specific user";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+                readonly description: "User ID or username";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "tribeunal_get_current_user";
+    readonly title: "Get current user";
+    readonly annotations: {
+        readonly title: "Get current user";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Get profile information for the currently authenticated user";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "tribeunal_jury_duty_status";
+    readonly title: "Jury duty status";
+    readonly annotations: {
+        readonly title: "Jury duty status";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Get current jury duty request status, queue position, and whether user has an active search or assignment";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "tribeunal_jury_duty_allowance";
+    readonly title: "Jury duty allowance";
+    readonly annotations: {
+        readonly title: "Jury duty allowance";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Get daily jury duty allowance info — how many requests used/remaining today, active jury count vs limit, and reset time";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "tribeunal_jury_duty_dashboard";
+    readonly title: "Jury duty dashboard";
+    readonly annotations: {
+        readonly title: "Jury duty dashboard";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Get jury duty dashboard with current case assignments (cases to vote on), allowance info, and active request status. Best tool for finding cases assigned to you.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "tribeunal_jury_duty_start";
+    readonly title: "Start jury duty session";
+    readonly annotations: {
+        readonly title: "Start jury duty session";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Start a jury duty search — join the matchmaking queue to be assigned to a case needing jurors. Consumes 1 daily allowance.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "tribeunal_jury_duty_cancel";
+    readonly title: "Cancel jury duty session";
+    readonly annotations: {
+        readonly title: "Cancel jury duty session";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Cancel an active jury duty search request. Refunds daily allowance if cancelled on the same day.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "tribeunal_jury_duty_accept";
+    readonly title: "Accept jury invitation";
+    readonly annotations: {
+        readonly title: "Accept jury invitation";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Accept a jury duty assignment to serve on a specific case";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly memberId: {
+                readonly type: "string";
+                readonly description: "Member ID from the jury assignment";
+            };
+        };
+        readonly required: readonly ["memberId"];
+    };
+}, {
+    readonly name: "tribeunal_jury_duty_reject";
+    readonly title: "Decline jury invitation";
+    readonly annotations: {
+        readonly title: "Decline jury invitation";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Reject a jury duty assignment and return to the queue for a different case";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly memberId: {
+                readonly type: "string";
+                readonly description: "Member ID from the jury assignment";
+            };
+        };
+        readonly required: readonly ["memberId"];
+    };
+}, {
+    readonly name: "tribeunal_jury_duty_history";
+    readonly title: "Jury duty history";
+    readonly annotations: {
+        readonly title: "Jury duty history";
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Get jury duty allowance usage history for the past N days (default 7, max 30)";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly days: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 30;
+                readonly default: 7;
+                readonly description: "Number of days of history to retrieve";
+            };
+        };
+    };
+}, {
+    readonly name: "tribeunal_join_jury";
+    readonly title: "Join a case jury";
+    readonly annotations: {
+        readonly title: "Join a case jury";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Seat yourself on a case's jury. Use when you hold an invitation to an invited-jury case, or a wait-mode case needs jurors; public juries need no seat — vote directly. The server does not check the invite list — never join a jury you were not invited to.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID of the jury to join";
+            };
+        };
+        readonly required: readonly ["caseId"];
+    };
+}, {
+    readonly name: "tribeunal_invite_jurors";
+    readonly title: "Invite jurors";
+    readonly annotations: {
+        readonly title: "Invite jurors";
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly description: "Invite users to the jury of a case you own (owner or admin only). Works on any case regardless of jury type — an invitation is recruitment, not restriction: it notifies the invitee, and merely opening the case page while logged in seats them as a normal juror (no separate accept step); it never restricts the open participation a public case already grants everyone. Provide `invitees` (usernames or emails) and/or a `tribeId` to invite an entire tribe (every current member plus the chieftain) — at least one is required. You must be a member, owner or admin of any tribe you name. Each invitee is processed independently — the response reports invited / duplicate / not_found per entry. The response also echoes the case url and, for a private case, its view-only shareUrl — when telling people about a private case, give them the shareUrl (the bare url 404s anyone without access).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly caseId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Case UUID (owner or admin only)";
+            };
+            readonly invitees: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly minItems: 1;
+                readonly maxItems: 50;
+                readonly description: "Usernames or email addresses to invite (1-50). Optional if tribeId is given.";
+            };
+            readonly tribeId: {
+                readonly type: "string";
+                readonly pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
+                readonly description: "Optional tribe UUID: invite every current member plus the chieftain. You must be a member, owner or admin of the tribe.";
+            };
+        };
+        readonly required: readonly ["caseId"];
+    };
+}];
+/** Shape of the value an MCP `tools/call` handler must return. */
+export interface ToolCallResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    [key: string]: unknown;
+}
+/**
+ * Dispatch a single tool call against an injected API client.
+ *
+ * This is the transport-agnostic heart of the server: the stdio `Server` and
+ * the Cloudflare `McpAgent` both funnel calls here so the tools behave
+ * identically regardless of how the caller authenticated.
+ */
+export declare function dispatchToolCall(apiClient: TribeunalAPIClient, toolName: string, args: unknown, ctx?: AwaitContext): Promise<ToolCallResult>;
+//# sourceMappingURL=tools.d.ts.map