pi2web 0.2.1 → 0.2.6

package/dist/collab/pi-extension.js

@@ -1,31 +1,76 @@
 import { randomUUID } from 'node:crypto';
 import { StringEnum } from '@earendil-works/pi-ai';
 import { Type } from 'typebox';
-export const COLLAB_ACTIONS = ['ready', 'findings', 'issue_votes', 'merge_votes', 'issue_discussions', 'nominations', 'votes', 'scores', 'debate_argument', 'debate_arguments', 'escalate', 'withdraw'];
+export const COLLAB_ACTIONS = [
+    'ready',
+    'findings',
+    'issue_votes',
+    'merge_votes',
+    'issue_discussions',
+    'nominations',
+    'votes',
+    'scores',
+    'debate_argument',
+    'debate_arguments',
+    'escalate',
+    'withdraw'
+];
 const evidence = Type.Object({
     path: Type.String({ minLength: 1, description: 'Workspace-relative evidence file' }),
-    startLine: Type.Optional(Type.Number({ minimum: 1 })), endLine: Type.Optional(Type.Number({ minimum: 1 })), excerpt: Type.Optional(Type.String({ maxLength: 2000 }))
+    startLine: Type.Optional(Type.Number({ minimum: 1 })),
+    endLine: Type.Optional(Type.Number({ minimum: 1 })),
+    excerpt: Type.Optional(Type.String({ maxLength: 2000 }))
 }, { additionalProperties: false });
 const location = Type.Object({
     path: Type.String({ minLength: 1, description: 'Workspace-relative file containing the finding' }),
-    startLine: Type.Optional(Type.Number({ minimum: 1 })), endLine: Type.Optional(Type.Number({ minimum: 1 }))
+    startLine: Type.Optional(Type.Number({ minimum: 1 })),
+    endLine: Type.Optional(Type.Number({ minimum: 1 }))
 }, { additionalProperties: false });
 const finding = Type.Object({
-    externalId: Type.Optional(Type.String({ maxLength: 100 })), title: Type.String({ minLength: 8, maxLength: 200 }),
+    externalId: Type.Optional(Type.String({ maxLength: 100 })),
+    title: Type.String({ minLength: 8, maxLength: 200 }),
     severity: StringEnum(['blocker', 'critical', 'major', 'minor', 'nit']),
-    category: StringEnum(['security', 'correctness', 'performance', 'maintainability', 'style', 'test', 'docs', 'process']),
-    requiredAction: Type.Optional(StringEnum(['must_fix', 'should_fix', 'discuss', 'fyi'])), confidence: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
-    location, evidence: Type.String({ minLength: 10, maxLength: 4000 }), impact: Type.Optional(Type.String({ maxLength: 2000 })), suggestion: Type.Optional(Type.String({ maxLength: 4000 }))
+    category: StringEnum([
+        'security',
+        'correctness',
+        'performance',
+        'maintainability',
+        'style',
+        'test',
+        'docs',
+        'process'
+    ]),
+    requiredAction: Type.Optional(StringEnum(['must_fix', 'should_fix', 'discuss', 'fyi'])),
+    confidence: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
+    location,
+    evidence: Type.String({ minLength: 10, maxLength: 4000 }),
+    impact: Type.Optional(Type.String({ maxLength: 2000 })),
+    suggestion: Type.Optional(Type.String({ maxLength: 4000 }))
 }, { additionalProperties: false });
 const TOOL_FOR_TASK = {
-    implement: 'collab_submit_ready', file_findings: 'collab_submit_findings', file_findings_optional: 'collab_submit_findings', validate_issues: 'collab_submit_issue_votes',
-    vote_on_merges: 'collab_submit_merge_votes', defend_approved_issues: 'collab_submit_issue_discussions', reconsider_issue_votes: 'collab_submit_issue_votes',
-    nominate_criteria: 'collab_submit_nominations', vote_on_criteria: 'collab_submit_votes', score_rubric: 'collab_submit_scores', rescore_contested: 'collab_submit_scores',
+    implement: 'collab_submit_ready',
+    file_findings: 'collab_submit_findings',
+    file_findings_optional: 'collab_submit_findings',
+    validate_issues: 'collab_submit_issue_votes',
+    vote_on_merges: 'collab_submit_merge_votes',
+    defend_approved_issues: 'collab_submit_issue_discussions',
+    reconsider_issue_votes: 'collab_submit_issue_votes',
+    nominate_criteria: 'collab_submit_nominations',
+    vote_on_criteria: 'collab_submit_votes',
+    score_rubric: 'collab_submit_scores',
+    rescore_contested: 'collab_submit_scores',
     debate_contested_scores: 'collab_submit_debate_arguments'
 };
 const TASK_FOR_ACTION = {
-    ready: ['implement'], findings: ['file_findings', 'file_findings_optional'], issue_votes: ['validate_issues', 'reconsider_issue_votes'], merge_votes: ['vote_on_merges'],
-    issue_discussions: ['defend_approved_issues'], nominations: ['nominate_criteria'], votes: ['vote_on_criteria'], scores: ['score_rubric', 'rescore_contested'], debate_arguments: ['debate_contested_scores']
+    ready: ['implement'],
+    findings: ['file_findings', 'file_findings_optional'],
+    issue_votes: ['validate_issues', 'reconsider_issue_votes'],
+    merge_votes: ['vote_on_merges'],
+    issue_discussions: ['defend_approved_issues'],
+    nominations: ['nominate_criteria'],
+    votes: ['vote_on_criteria'],
+    scores: ['score_rubric', 'rescore_contested'],
+    debate_arguments: ['debate_contested_scores']
 };
 const SUBMIT_TOOLS = [...new Set(Object.values(TOOL_FOR_TASK))];
 const OPTIONAL_TOOLS = ['collab_escalate', 'collab_withdraw_issue'];
@@ -44,7 +89,19 @@ export function createCollabExtension(agentId, bridge) {
             const existing = aliases.get(id);
             if (existing)
                 return existing;
-            const prefix = kind === 'issue' ? 'issue' : kind === 'criterion' ? 'criterion' : kind === 'proposal' ? 'proposal' : kind === 'debate' ? 'debate' : kind === 'baseline' ? 'base' : kind === 'participant' ? 'reviewer' : 'ref';
+            const prefix = kind === 'issue'
+                ? 'issue'
+                : kind === 'criterion'
+                    ? 'criterion'
+                    : kind === 'proposal'
+                        ? 'proposal'
+                        : kind === 'debate'
+                            ? 'debate'
+                            : kind === 'baseline'
+                                ? 'base'
+                                : kind === 'participant'
+                                    ? 'reviewer'
+                                    : 'ref';
             const value = `${prefix}-${[...aliases.values()].filter(entry => entry.startsWith(`${prefix}-`)).length + 1}`;
             aliases.set(id, value);
             return value;
@@ -58,10 +115,27 @@ export function createCollabExtension(agentId, bridge) {
             for (const [name, entry] of Object.entries(value)) {
                 if (name === 'sessionId')
                     continue;
-                const ids = typeof entry === 'string' ? [entry] : Array.isArray(entry) && entry.every(item => typeof item === 'string') ? entry : undefined;
+                const ids = typeof entry === 'string'
+                    ? [entry]
+                    : Array.isArray(entry) && entry.every(item => typeof item === 'string')
+                        ? entry
+                        : undefined;
                 if (ids && /(Id|Ids)$/.test(name)) {
-                    const kind = /issue/i.test(name) ? 'issue' : /criterion/i.test(name) ? 'criterion' : /proposal/i.test(name) ? 'proposal' : /debate/i.test(name) ? 'debate' : /baseline/i.test(name) ? 'baseline' : /participant|author|reporter|target|raisedBy/i.test(name) ? 'participant' : 'ref';
-                    output[name.replace(/Id(s)?$/, 'Ref$1')] = typeof entry === 'string' ? reference(entry, kind) : ids.map(item => reference(item, kind));
+                    const kind = /issue/i.test(name)
+                        ? 'issue'
+                        : /criterion/i.test(name)
+                            ? 'criterion'
+                            : /proposal/i.test(name)
+                                ? 'proposal'
+                                : /debate/i.test(name)
+                                    ? 'debate'
+                                    : /baseline/i.test(name)
+                                        ? 'baseline'
+                                        : /participant|author|reporter|target|raisedBy/i.test(name)
+                                            ? 'participant'
+                                            : 'ref';
+                    output[name.replace(/Id(s)?$/, 'Ref$1')] =
+                        typeof entry === 'string' ? reference(entry, kind) : ids.map(item => reference(item, kind));
                 }
                 else
                     output[name] = redact(entry);
@@ -76,8 +150,10 @@ export function createCollabExtension(agentId, bridge) {
          */
         const seed = (task) => {
             const counters = new Map();
-            const claim = (id, alias) => { if (typeof id === 'string' && id && !aliases.has(id))
-                aliases.set(id, alias); };
+            const claim = (id, alias) => {
+                if (typeof id === 'string' && id && !aliases.has(id))
+                    aliases.set(id, alias);
+            };
             for (const seat of Array.isArray(task.panel) ? task.panel : []) {
                 const role = typeof seat.role === 'string' ? seat.role : 'participant', next = (counters.get(role) ?? 0) + 1;
                 counters.set(role, next);
@@ -116,8 +192,13 @@ export function createCollabExtension(agentId, bridge) {
             }
             // Only alias-carrying keys are translated back to hub ids. `codeRef` is a semantic field whose value is an
             // object (commit/dirtyHash), so renaming it to `codeId` would make the hub reject a valid ready submission.
-            const isAliasKey = (key, entry) => /Ref(s)?$/.test(key) && (typeof entry === 'string' || (Array.isArray(entry) && entry.every(item => typeof item === 'string')));
-            return Object.fromEntries(Object.entries(value).map(([key, entry]) => [isAliasKey(key, entry) ? key.replace(/Ref(s)?$/, 'Id$1') : key, restore(entry)]));
+            const isAliasKey = (key, entry) => /Ref(s)?$/.test(key) &&
+                (typeof entry === 'string' ||
+                    (Array.isArray(entry) && entry.every(item => typeof item === 'string')));
+            return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
+                isAliasKey(key, entry) ? key.replace(/Ref(s)?$/, 'Id$1') : key,
+                restore(entry)
+            ]));
         };
         const taskText = (task) => {
             const safe = redact(task), context = { ...safe };
@@ -140,14 +221,18 @@ export function createCollabExtension(agentId, bridge) {
             if (Object.keys(context).length)
                 lines.push(`Task context:\n${JSON.stringify(context, null, 2)}`);
             const submit = TOOL_FOR_TASK[String(safe.task ?? '')];
-            lines.push(submit ? `Complete every required Ref with ${submit}, then end the turn.` : 'No submission is required; end the turn.');
+            lines.push(submit
+                ? `Complete every required Ref with ${submit}, then end the turn.`
+                : 'No submission is required; end the turn.');
             return lines.join('\n');
         };
         const currentTask = () => String(lastTask?.task ?? '');
         const normalize = (action, payload) => {
             const body = restore(payload);
             if (action === 'findings') {
-                if (!body.baselineId && lastTask?.baseline && typeof lastTask.baseline.baselineId === 'string')
+                if (!body.baselineId &&
+                    lastTask?.baseline &&
+                    typeof lastTask.baseline.baselineId === 'string')
                     body.baselineId = lastTask.baseline.baselineId;
                 body.reviewComplete = true;
             }
@@ -157,16 +242,29 @@ export function createCollabExtension(agentId, bridge) {
                 body.clientRequestId = randomUUID();
             return body;
         };
-        const rememberBaseTools = () => { if (!baseTools)
-            baseTools = pi.getActiveTools().filter(name => !SUBMIT_TOOLS.includes(name) && !OPTIONAL_TOOLS.includes(name) && name !== 'collab_get_task'); };
+        const rememberBaseTools = () => {
+            if (!baseTools)
+                baseTools = pi
+                    .getActiveTools()
+                    .filter(name => !SUBMIT_TOOLS.includes(name) && !OPTIONAL_TOOLS.includes(name) && name !== 'collab_get_task');
+        };
         const activate = (task) => {
             rememberBaseTools();
             const taskName = String(task?.task ?? '');
             // Tool names are not an integrity boundary: bash can write just as readily as edit/write, while edit/write
             // may still be useful for scratch work outside the reviewed checkout. Keep the normal tools available,
             // state the non-mutation contract explicitly, and let the baseline comparison enforce workspace identity.
-            const submit = TOOL_FOR_TASK[taskName], optional = taskName && taskName !== 'wait' ? ['collab_escalate', ...(taskName.includes('issue') || taskName === 'validate_issues' ? ['collab_withdraw_issue'] : [])] : [];
-            pi.setActiveTools([...new Set([...baseTools, 'collab_get_task', ...(submit ? [submit] : []), ...optional])]);
+            const submit = TOOL_FOR_TASK[taskName], optional = taskName && taskName !== 'wait'
+                ? [
+                    'collab_escalate',
+                    ...(taskName.includes('issue') || taskName === 'validate_issues'
+                        ? ['collab_withdraw_issue']
+                        : [])
+                ]
+                : [];
+            pi.setActiveTools([
+                ...new Set([...baseTools, 'collab_get_task', ...(submit ? [submit] : []), ...optional])
+            ]);
         };
         const assertTask = (action) => {
             const allowed = TASK_FOR_ACTION[action];
@@ -175,13 +273,23 @@ export function createCollabExtension(agentId, bridge) {
         };
         const acceptedText = (result) => `Collaboration submission accepted.${result && typeof result === 'object' ? ` ${JSON.stringify(redact(result))}` : ''}`;
         const registerSubmit = (definition) => pi.registerTool({
-            name: definition.name, label: definition.label, description: definition.description, promptSnippet: definition.description,
-            promptGuidelines: [`Use ${definition.name} only after collab_get_task requests it, and include every required Ref exactly once.`], parameters: definition.parameters,
+            name: definition.name,
+            label: definition.label,
+            description: definition.description,
+            promptSnippet: definition.description,
+            promptGuidelines: [
+                `Use ${definition.name} only after collab_get_task requests it, and include every required Ref exactly once.`
+            ],
+            parameters: definition.parameters,
             async execute(_id, input) {
                 try {
                     assertTask(definition.action);
                     const result = await bridge.submit(agentId, definition.action, normalize(definition.action, input));
-                    return { content: [{ type: 'text', text: acceptedText(result) }], details: { result: redact(result) }, terminate: definition.terminate ?? true };
+                    return {
+                        content: [{ type: 'text', text: acceptedText(result) }],
+                        details: { result: redact(result) },
+                        terminate: definition.terminate ?? true
+                    };
                 }
                 catch (error) {
                     const fields = error.fieldErrors;
@@ -189,49 +297,198 @@ export function createCollabExtension(agentId, bridge) {
                 }
             }
         });
-        pi.on('session_start', () => { baseTools = undefined; lastTask = undefined; aliases = new Map(); activate(); });
+        pi.on('session_start', () => {
+            baseTools = undefined;
+            lastTask = undefined;
+            aliases = new Map();
+            activate();
+        });
         pi.on('before_agent_start', event => {
             lastTask = undefined;
             aliases = new Map();
             activate();
-            return { systemPrompt: `${event.systemPrompt}\n\n## Local collaboration\nThis is a local software-development workflow. Call collab_get_task first after every collaboration wake-up. Use only the collaboration submission tool activated for that task. Review and scoring are strictly non-mutating: bash may inspect with commands such as git diff/log, but must not write anywhere under the working directory—not through redirection, tee, file-management commands, formatters, generators, package installation, build artifacts, caches, or scratch files. Send command output to stdout, or if temporary storage is unavoidable use the OS temporary directory outside the workspace. Only an implement task may modify the workspace. The tools own transport and credentials: never use curl, invent endpoints or identifiers, sleep, or poll.` };
+            return {
+                systemPrompt: `${event.systemPrompt}\n\n## Local collaboration\nThis is a local software-development workflow. Call collab_get_task first after every collaboration wake-up. Use only the collaboration submission tool activated for that task. Review and scoring are strictly non-mutating: bash may inspect with commands such as git diff/log, but must not write anywhere under the working directory—not through redirection, tee, file-management commands, formatters, generators, package installation, build artifacts, caches, or scratch files. Send command output to stdout, or if temporary storage is unavoidable use the OS temporary directory outside the workspace. Only an implement task may modify the workspace. The tools own transport and credentials: never use curl, invent endpoints or identifiers, sleep, or poll.`
+            };
         });
         pi.registerTool({
-            name: 'collab_get_task', label: 'Get Collaboration Task', description: 'Get the complete current collaboration assignment and activate its exact typed submission tool.',
-            promptSnippet: 'Fetch the current collaboration assignment before doing any collaboration work', promptGuidelines: ['Call collab_get_task first after every pi2web collaboration wake-up.'], parameters: Type.Object({}, { additionalProperties: false }),
-            async execute() { aliases = new Map(); lastTask = await bridge.getTask(agentId); seed(lastTask); activate(lastTask); return { content: [{ type: 'text', text: taskText(lastTask) }], details: { task: redact(lastTask) } }; }
+            name: 'collab_get_task',
+            label: 'Get Collaboration Task',
+            description: 'Get the complete current collaboration assignment and activate its exact typed submission tool.',
+            promptSnippet: 'Fetch the current collaboration assignment before doing any collaboration work',
+            promptGuidelines: ['Call collab_get_task first after every pi2web collaboration wake-up.'],
+            parameters: Type.Object({}, { additionalProperties: false }),
+            async execute() {
+                aliases = new Map();
+                lastTask = await bridge.getTask(agentId);
+                seed(lastTask);
+                activate(lastTask);
+                return { content: [{ type: 'text', text: taskText(lastTask) }], details: { task: redact(lastTask) } };
+            }
         });
-        registerSubmit({ name: 'collab_submit_ready', label: 'Submit Implementation', action: 'ready', description: 'Declare the assigned implementation complete with an auditable change summary.', parameters: Type.Object({
-                summary: Type.String({ minLength: 10, maxLength: 4000 }), changes: Type.Array(Type.Object({ path: Type.String({ minLength: 1 }), summary: Type.String({ minLength: 5 }) }, { additionalProperties: false }), { maxItems: 100 }),
+        registerSubmit({
+            name: 'collab_submit_ready',
+            label: 'Submit Implementation',
+            action: 'ready',
+            description: 'Declare the assigned implementation complete with an auditable change summary.',
+            parameters: Type.Object({
+                summary: Type.String({ minLength: 10, maxLength: 4000 }),
+                changes: Type.Array(Type.Object({ path: Type.String({ minLength: 1 }), summary: Type.String({ minLength: 5 }) }, { additionalProperties: false }), { maxItems: 100 }),
                 codeRef: Type.Optional(Type.Object({ commit: Type.Optional(Type.String()), dirtyHash: Type.Optional(Type.String()) }, { additionalProperties: false }))
-            }, { additionalProperties: false }) });
-        registerSubmit({ name: 'collab_submit_findings', label: 'Submit Review Findings', action: 'findings', description: 'Submit the complete blind review, including every required recheck and all new evidence-backed findings.', parameters: Type.Object({
-                findings: Type.Array(finding, { maxItems: 50 }), rechecks: Type.Optional(Type.Array(Type.Object({ issueRef: Type.String(), outcome: StringEnum(['resolved', 'still_present']), rationale: Type.String({ minLength: 10, maxLength: 4000 }) }, { additionalProperties: false }), { maxItems: 100 }))
-            }, { additionalProperties: false }) });
-        registerSubmit({ name: 'collab_submit_issue_votes', label: 'Submit Issue Votes', action: 'issue_votes', description: 'Vote on every required issue and optionally propose duplicate groups.', parameters: Type.Object({
-                votes: Type.Array(Type.Object({ issueRef: Type.String(), stance: StringEnum(['approve', 'reject']), rationale: Type.Optional(Type.String({ maxLength: 4000 })) }, { additionalProperties: false }), { maxItems: 200, description: 'One vote per Ref in yourRequiredIssueIds; an empty array is only accepted when you owe none' }),
-                mergeProposals: Type.Optional(Type.Array(Type.Object({ issueRefs: Type.Array(Type.String(), { minItems: 2, maxItems: 20 }), rationale: Type.String({ minLength: 10, maxLength: 2000 }) }, { additionalProperties: false }), { maxItems: 50 }))
-            }, { additionalProperties: false }) });
-        registerSubmit({ name: 'collab_submit_merge_votes', label: 'Submit Merge Votes', action: 'merge_votes', description: 'Vote on every required duplicate-merge proposal.', parameters: Type.Object({ votes: Type.Array(Type.Object({ proposalRef: Type.String(), stance: StringEnum(['approve', 'reject']), rationale: Type.Optional(Type.String({ maxLength: 4000 })) }, { additionalProperties: false }), { minItems: 1, maxItems: 100 }) }, { additionalProperties: false }) });
-        registerSubmit({ name: 'collab_submit_issue_discussions', label: 'Submit Issue Arguments', action: 'issue_discussions', description: 'Defend every required finding with evidence, and withdraw the ones you no longer stand by.', parameters: Type.Object({
-                discussions: Type.Optional(Type.Array(Type.Object({ issueRef: Type.String(), argument: Type.String({ minLength: 20, maxLength: 4000 }), respondingTo: Type.Optional(Type.String()) }, { additionalProperties: false }), { maxItems: 200 })),
-                withdrawals: Type.Optional(Type.Array(Type.Object({ issueRef: Type.String(), rationale: Type.String({ minLength: 10, maxLength: 4000, description: 'Why you no longer stand by your own finding' }) }, { additionalProperties: false }), { maxItems: 200 }))
-            }, { additionalProperties: false }) });
-        registerSubmit({ name: 'collab_submit_nominations', label: 'Submit Criteria Nominations', action: 'nominations', description: 'Submit the complete independent set of proposed scoring criteria.', parameters: Type.Object({ nominations: Type.Array(Type.Object({
-                    externalId: Type.Optional(Type.String()), name: Type.String({ minLength: 2, maxLength: 80 }), definition: Type.String({ minLength: 20, maxLength: 2000 }), weightSuggestion: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })), anchors: Type.Optional(Type.Record(Type.String(), Type.String())), rationale: Type.Optional(Type.String({ maxLength: 2000 }))
-                }, { additionalProperties: false }), { maxItems: 20 }) }, { additionalProperties: false }) });
-        registerSubmit({ name: 'collab_submit_votes', label: 'Submit Criteria Votes', action: 'votes', description: 'Vote exactly once on every required rubric candidate.', parameters: Type.Object({ votes: Type.Array(Type.Object({
-                    criterionRef: Type.String(), stance: StringEnum(['approve', 'reject', 'abstain']), weight: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })), amendment: Type.Optional(Type.String({ maxLength: 1000 })), rationale: Type.Optional(Type.String({ maxLength: 2000 }))
-                }, { additionalProperties: false }), { minItems: 1, maxItems: 40 }) }, { additionalProperties: false }) });
-        registerSubmit({ name: 'collab_submit_scores', label: 'Submit Rubric Scores', action: 'scores', description: 'Score exactly once every required criterion with rationale and file evidence.', parameters: Type.Object({ scores: Type.Array(Type.Object({
-                    criterionRef: Type.String(), score: Type.Number(), rationale: Type.String({ minLength: 20, maxLength: 4000 }), evidence: Type.Array(evidence, { minItems: 1, maxItems: 20 }), confidence: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })), changeReason: Type.Optional(Type.String({ maxLength: 2000 }))
-                }, { additionalProperties: false }), { minItems: 1, maxItems: 40 }) }, { additionalProperties: false }) });
-        registerSubmit({ name: 'collab_submit_debate_arguments', label: 'Submit Score Debate', action: 'debate_arguments', description: 'Submit one evidence-backed position for every required contested-criterion debate.', parameters: Type.Object({ arguments: Type.Array(Type.Object({
-                    debateRef: Type.String(), stance: StringEnum(['raise', 'lower', 'hold']), argument: Type.String({ minLength: 20, maxLength: 4000 }), evidence: Type.Optional(Type.Array(evidence, { maxItems: 20 })), respondingTo: Type.Optional(Type.String())
-                }, { additionalProperties: false }), { minItems: 1, maxItems: 40 }) }, { additionalProperties: false }) });
-        registerSubmit({ name: 'collab_escalate', label: 'Escalate Collaboration', action: 'escalate', description: 'Escalate a genuine blocker or unresolved judgment to the human operator.', terminate: false, parameters: Type.Object({
-                kind: StringEnum(['issue_dispute', 'rubric_dispute', 'score_dispute', 'other']), refRef: Type.Optional(Type.String()), summary: Type.String({ minLength: 20, maxLength: 2000 }), question: Type.String({ minLength: 10, maxLength: 1000 }), options: Type.Optional(Type.Array(Type.String(), { maxItems: 10 })), urgency: Type.Optional(StringEnum(['low', 'normal', 'high']))
-            }, { additionalProperties: false }) });
-        registerSubmit({ name: 'collab_withdraw_issue', label: 'Withdraw Issue', action: 'withdraw', description: 'Withdraw one of your own findings when you no longer stand by it. Does not end your turn.', terminate: false, parameters: Type.Object({ issueRef: Type.String() }, { additionalProperties: false }) });
+            }, { additionalProperties: false })
+        });
+        registerSubmit({
+            name: 'collab_submit_findings',
+            label: 'Submit Review Findings',
+            action: 'findings',
+            description: 'Submit the complete blind review, including every required recheck and all new evidence-backed findings.',
+            parameters: Type.Object({
+                findings: Type.Array(finding, { maxItems: 50 }),
+                rechecks: Type.Optional(Type.Array(Type.Object({
+                    issueRef: Type.String(),
+                    outcome: StringEnum(['resolved', 'still_present']),
+                    rationale: Type.String({ minLength: 10, maxLength: 4000 })
+                }, { additionalProperties: false }), { maxItems: 100 }))
+            }, { additionalProperties: false })
+        });
+        registerSubmit({
+            name: 'collab_submit_issue_votes',
+            label: 'Submit Issue Votes',
+            action: 'issue_votes',
+            description: 'Vote on every required issue and optionally propose duplicate groups.',
+            parameters: Type.Object({
+                votes: Type.Array(Type.Object({
+                    issueRef: Type.String(),
+                    stance: StringEnum(['approve', 'reject']),
+                    rationale: Type.Optional(Type.String({ maxLength: 4000 }))
+                }, { additionalProperties: false }), {
+                    maxItems: 200,
+                    description: 'One vote per Ref in yourRequiredIssueIds; an empty array is only accepted when you owe none'
+                }),
+                mergeProposals: Type.Optional(Type.Array(Type.Object({
+                    issueRefs: Type.Array(Type.String(), { minItems: 2, maxItems: 20 }),
+                    rationale: Type.String({ minLength: 10, maxLength: 2000 })
+                }, { additionalProperties: false }), { maxItems: 50 }))
+            }, { additionalProperties: false })
+        });
+        registerSubmit({
+            name: 'collab_submit_merge_votes',
+            label: 'Submit Merge Votes',
+            action: 'merge_votes',
+            description: 'Vote on every required duplicate-merge proposal.',
+            parameters: Type.Object({
+                votes: Type.Array(Type.Object({
+                    proposalRef: Type.String(),
+                    stance: StringEnum(['approve', 'reject']),
+                    rationale: Type.Optional(Type.String({ maxLength: 4000 }))
+                }, { additionalProperties: false }), { minItems: 1, maxItems: 100 })
+            }, { additionalProperties: false })
+        });
+        registerSubmit({
+            name: 'collab_submit_issue_discussions',
+            label: 'Submit Issue Arguments',
+            action: 'issue_discussions',
+            description: 'Defend every required finding with evidence, and withdraw the ones you no longer stand by.',
+            parameters: Type.Object({
+                discussions: Type.Optional(Type.Array(Type.Object({
+                    issueRef: Type.String(),
+                    argument: Type.String({ minLength: 20, maxLength: 4000 }),
+                    respondingTo: Type.Optional(Type.String())
+                }, { additionalProperties: false }), { maxItems: 200 })),
+                withdrawals: Type.Optional(Type.Array(Type.Object({
+                    issueRef: Type.String(),
+                    rationale: Type.String({
+                        minLength: 10,
+                        maxLength: 4000,
+                        description: 'Why you no longer stand by your own finding'
+                    })
+                }, { additionalProperties: false }), { maxItems: 200 }))
+            }, { additionalProperties: false })
+        });
+        registerSubmit({
+            name: 'collab_submit_nominations',
+            label: 'Submit Criteria Nominations',
+            action: 'nominations',
+            description: 'Submit the complete independent set of proposed scoring criteria.',
+            parameters: Type.Object({
+                nominations: Type.Array(Type.Object({
+                    externalId: Type.Optional(Type.String()),
+                    name: Type.String({ minLength: 2, maxLength: 80 }),
+                    definition: Type.String({ minLength: 20, maxLength: 2000 }),
+                    weightSuggestion: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
+                    anchors: Type.Optional(Type.Record(Type.String(), Type.String())),
+                    rationale: Type.Optional(Type.String({ maxLength: 2000 }))
+                }, { additionalProperties: false }), { maxItems: 20 })
+            }, { additionalProperties: false })
+        });
+        registerSubmit({
+            name: 'collab_submit_votes',
+            label: 'Submit Criteria Votes',
+            action: 'votes',
+            description: 'Vote exactly once on every required rubric candidate.',
+            parameters: Type.Object({
+                votes: Type.Array(Type.Object({
+                    criterionRef: Type.String(),
+                    stance: StringEnum(['approve', 'reject', 'abstain']),
+                    weight: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
+                    amendment: Type.Optional(Type.String({ maxLength: 1000 })),
+                    rationale: Type.Optional(Type.String({ maxLength: 2000 }))
+                }, { additionalProperties: false }), { minItems: 1, maxItems: 40 })
+            }, { additionalProperties: false })
+        });
+        registerSubmit({
+            name: 'collab_submit_scores',
+            label: 'Submit Rubric Scores',
+            action: 'scores',
+            description: 'Score exactly once every required criterion with rationale and file evidence.',
+            parameters: Type.Object({
+                scores: Type.Array(Type.Object({
+                    criterionRef: Type.String(),
+                    score: Type.Number(),
+                    rationale: Type.String({ minLength: 20, maxLength: 4000 }),
+                    evidence: Type.Array(evidence, { minItems: 1, maxItems: 20 }),
+                    confidence: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
+                    changeReason: Type.Optional(Type.String({ maxLength: 2000 }))
+                }, { additionalProperties: false }), { minItems: 1, maxItems: 40 })
+            }, { additionalProperties: false })
+        });
+        registerSubmit({
+            name: 'collab_submit_debate_arguments',
+            label: 'Submit Score Debate',
+            action: 'debate_arguments',
+            description: 'Submit one evidence-backed position for every required contested-criterion debate.',
+            parameters: Type.Object({
+                arguments: Type.Array(Type.Object({
+                    debateRef: Type.String(),
+                    stance: StringEnum(['raise', 'lower', 'hold']),
+                    argument: Type.String({ minLength: 20, maxLength: 4000 }),
+                    evidence: Type.Optional(Type.Array(evidence, { maxItems: 20 })),
+                    respondingTo: Type.Optional(Type.String())
+                }, { additionalProperties: false }), { minItems: 1, maxItems: 40 })
+            }, { additionalProperties: false })
+        });
+        registerSubmit({
+            name: 'collab_escalate',
+            label: 'Escalate Collaboration',
+            action: 'escalate',
+            description: 'Escalate a genuine blocker or unresolved judgment to the human operator.',
+            terminate: false,
+            parameters: Type.Object({
+                kind: StringEnum(['issue_dispute', 'rubric_dispute', 'score_dispute', 'other']),
+                refRef: Type.Optional(Type.String()),
+                summary: Type.String({ minLength: 20, maxLength: 2000 }),
+                question: Type.String({ minLength: 10, maxLength: 1000 }),
+                options: Type.Optional(Type.Array(Type.String(), { maxItems: 10 })),
+                urgency: Type.Optional(StringEnum(['low', 'normal', 'high']))
+            }, { additionalProperties: false })
+        });
+        registerSubmit({
+            name: 'collab_withdraw_issue',
+            label: 'Withdraw Issue',
+            action: 'withdraw',
+            description: 'Withdraw one of your own findings when you no longer stand by it. Does not end your turn.',
+            terminate: false,
+            parameters: Type.Object({ issueRef: Type.String() }, { additionalProperties: false })
+        });
     };
 }