@brightbeamai/chap-coordinator-mcp 0.2.9

package/dist/schemas.js

@@ -0,0 +1,600 @@
+// src/schemas.ts
+var PARTICIPANT_URI = {
+  type: "string",
+  description: "Participant URI, e.g. 'human:alice@example.org' or 'agent:bot@local'."
+};
+var WORKSPACE_ID = {
+  type: "string",
+  description: "Workspace identifier, e.g. 'wsp_techcorp_support'."
+};
+var TASK_ID = {
+  type: "string",
+  description: "Task identifier returned by chap.task.create."
+};
+var ROUTING_HINTS = {
+  type: "object",
+  description: "Optional signals for the routing/1.0 profile.",
+  properties: {
+    criticality: { type: "string", enum: ["low", "medium", "high", "critical"] },
+    deadline: { type: "string", description: "ISO 8601 timestamp." },
+    risk_tier: { type: "string" },
+    max_cost_usd: { type: "number" }
+  },
+  additionalProperties: true
+};
+var SCHEMAS = {
+  "chap.workspace.create": {
+    type: "object",
+    properties: {
+      workspace: { ...WORKSPACE_ID, description: "Workspace id to create. If omitted, one is generated." },
+      profiles: {
+        type: "array",
+        items: { type: "string" },
+        description: "Profile identifiers to enable, e.g. ['core/1.0', 'review/1.0']."
+      },
+      mode: { type: "string", enum: ["shadow", "trial", "production"], default: "trial" },
+      mode_ceiling: { type: "string", enum: ["shadow", "trial", "production"], default: "production" }
+    },
+    additionalProperties: false
+  },
+  "chap.workspace.describe": {
+    type: "object",
+    properties: { workspace: WORKSPACE_ID },
+    required: ["workspace"]
+  },
+  "chap.workspace.set_profiles": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      profiles: { type: "array", items: { type: "string" } }
+    },
+    required: ["workspace", "profiles"]
+  },
+  "chap.participant.join": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      type: { type: "string", enum: ["human", "agent", "service", "group", "workspace"] },
+      role: { type: "string", description: "Operator-defined role, e.g. 'reviewer' or 'drafter'." },
+      display_name: { type: "string" }
+    },
+    required: ["workspace", "from", "type"]
+  },
+  "chap.participant.leave": {
+    type: "object",
+    properties: { workspace: WORKSPACE_ID, from: PARTICIPANT_URI },
+    required: ["workspace", "from"]
+  },
+  "chap.task.create": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: { ...PARTICIPANT_URI, description: "Delegator URI." },
+      kind: { type: "string", description: "Task kind, e.g. 'draft_response' or 'review'." },
+      assignee: { ...PARTICIPANT_URI, description: "Who the task is assigned to. Must be a workspace member." },
+      input: { type: "object", description: "Task-specific input payload.", additionalProperties: true },
+      routing_hints: ROUTING_HINTS,
+      mode: { type: "string", enum: ["shadow", "trial", "production"] }
+    },
+    required: ["workspace", "from", "kind", "assignee", "input"]
+  },
+  "chap.task.update": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      state: { type: "string", enum: ["in_progress", "review_requested", "declined", "paused", "cancelled", "completed"] },
+      progress_note: { type: "string" }
+    },
+    required: ["workspace", "from", "task_id", "state"]
+  },
+  "chap.task.complete": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      output: { description: "The task's output artefact. Pass as a JSON object or array, not a JSON-encoded string." },
+      confidence: { type: "number", description: "Self-reported confidence (0-1), where supported." },
+      routing_hints: ROUTING_HINTS
+    },
+    required: ["workspace", "from", "task_id"]
+  },
+  "chap.audit.read": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      range: {
+        type: "object",
+        properties: {
+          from_seq: { type: "integer", description: "Start sequence number (inclusive)." },
+          to_seq: { type: "integer", description: "End sequence number (exclusive)." }
+        }
+      },
+      filter: {
+        type: "object",
+        properties: {
+          method: { type: "string" },
+          from: { type: "string" },
+          task_id: { type: "string" }
+        }
+      }
+    },
+    required: ["workspace"]
+  },
+  // ============================================================
+  //   review/1.0
+  // ============================================================
+  "chap.review.request": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      to: {
+        oneOf: [PARTICIPANT_URI, { type: "array", items: PARTICIPANT_URI }],
+        description: "One or more reviewers. A single URI string, or a JSON array of URI strings (not a JSON-encoded string)."
+      },
+      rule: {
+        type: "string",
+        enum: ["any_one_approves", "all_approve", "quorum:2", "quorum:3"],
+        default: "any_one_approves"
+      },
+      artefact: { description: "The draft being submitted for review. Pass as a JSON object or array, not a JSON-encoded string." },
+      deadline: { type: "string" }
+    },
+    required: ["workspace", "from", "task_id", "to", "artefact"]
+  },
+  "chap.decide.approve": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      comment: { type: "string" },
+      tags: { type: "array", items: { type: "string" } }
+    },
+    required: ["workspace", "from", "task_id"]
+  },
+  "chap.decide.reject": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      comment: { type: "string" },
+      tags: { type: "array", items: { type: "string" } },
+      request_revision: { type: "boolean", description: "If true, task returns to in_progress instead of declined." }
+    },
+    required: ["workspace", "from", "task_id"]
+  },
+  "chap.decide.override": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      diff: {
+        type: "array",
+        description: "RFC 6902 JSON Patch operations applied to the artefact under review.",
+        items: {
+          type: "object",
+          properties: {
+            op: { type: "string", enum: ["add", "replace", "remove", "copy", "move", "test"] },
+            path: { type: "string" },
+            value: {},
+            from: { type: "string" }
+          },
+          required: ["op", "path"]
+        }
+      },
+      rationale: { type: "string", description: "Why the override was applied. Required for the structured-override audit trail." },
+      tags: { type: "array", items: { type: "string" } },
+      policy_refs: { type: "array", items: { type: "string" } },
+      logical_id: { type: "string" },
+      intent_preserved: { type: "boolean" }
+    },
+    required: ["workspace", "from", "task_id", "diff", "rationale"]
+  },
+  "chap.abstain.declare": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      reason: { type: "string" },
+      category: { type: "string", enum: ["conflict_of_interest", "insufficient_context", "out_of_scope", "other"] }
+    },
+    required: ["workspace", "from", "task_id", "reason"]
+  },
+  "chap.escalate.raise": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      original_task_id: TASK_ID,
+      new_task: {
+        type: "object",
+        properties: {
+          kind: { type: "string" },
+          assignee: PARTICIPANT_URI,
+          input: { type: "object", additionalProperties: true }
+        },
+        required: ["assignee"]
+      }
+    },
+    required: ["workspace", "from", "original_task_id", "new_task"]
+  },
+  // ============================================================
+  //   whisper/1.0
+  // ============================================================
+  "chap.whisper.ask": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      to: { type: "array", items: PARTICIPANT_URI, description: "Who is being asked." },
+      question: { type: "string" },
+      options: {
+        type: "array",
+        items: { type: "object", properties: { id: { type: "string" }, label: { type: "string" } }, required: ["id"] },
+        description: "Optional multiple-choice options. If present, answer_option must be one of these ids."
+      },
+      deadline_ms: { type: "integer", description: "Time-to-live in milliseconds from now." },
+      default_if_lapsed: { description: "Value applied if the whisper lapses without an answer." },
+      urgency: { type: "string", enum: ["low", "medium", "high"], default: "low" }
+    },
+    required: ["workspace", "from", "task_id", "to", "question", "deadline_ms", "default_if_lapsed"]
+  },
+  "chap.whisper.answer": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      whisper_id: { type: "string" },
+      answer_option: { type: "string", description: "Option id (required when the whisper has options)." },
+      answer: { type: "string", description: "Free-text answer (when no options)." },
+      comment: { type: "string" }
+    },
+    required: ["workspace", "from", "whisper_id"]
+  },
+  // ============================================================
+  //   deliberation/1.0
+  // ============================================================
+  "chap.deliberate.open": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      to: { type: "array", items: PARTICIPANT_URI, description: "Deliberation participants." },
+      task_id: TASK_ID,
+      rule: {
+        type: "string",
+        description: "Voting rule. Examples: any_one_approves, all_approve, quorum:N, weighted_vote:T, weighted_vote_with_veto:T."
+      },
+      question: { type: "string" },
+      weights: { type: "object", additionalProperties: { type: "number" }, description: "Voter -> weight map (for weighted rules)." },
+      veto: { type: "object", additionalProperties: { type: "boolean" }, description: "Voter -> can-veto map." },
+      deadline: { type: "string" }
+    },
+    required: ["workspace", "from", "to", "rule"]
+  },
+  "chap.deliberate.comment": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      deliberation_id: { type: "string" },
+      comment: { type: "string" }
+    },
+    required: ["workspace", "from", "deliberation_id", "comment"]
+  },
+  "chap.deliberate.vote": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      deliberation_id: { type: "string" },
+      vote: { type: "string", enum: ["yea", "nay", "abstain"] },
+      weight: { type: "number" },
+      comment: { type: "string" },
+      veto_invoked: { type: "boolean" }
+    },
+    required: ["workspace", "from", "deliberation_id", "vote"]
+  },
+  "chap.deliberate.close": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      deliberation_id: { type: "string" }
+    },
+    required: ["workspace", "from", "deliberation_id"]
+  },
+  // ============================================================
+  //   handoff/1.0
+  // ============================================================
+  "chap.handoff.propose": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      to: { type: "string", description: "Recipient (URI or 'group:...')." },
+      tasks: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            task_id: TASK_ID,
+            title: { type: "string" },
+            status_summary: { type: "string" },
+            next_action: { type: "string" },
+            blockers: { type: "array", items: { type: "string" } }
+          },
+          required: ["task_id"]
+        }
+      },
+      summary: { type: "string" },
+      context_links: { type: "array", items: { type: "string" } }
+    },
+    required: ["workspace", "from", "to", "tasks"]
+  },
+  "chap.handoff.accept": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      handoff_id: { type: "string" },
+      accepted_task_ids: { type: "array", items: TASK_ID, description: "If omitted, all proposed tasks are accepted." },
+      comment: { type: "string" }
+    },
+    required: ["workspace", "from", "handoff_id"]
+  },
+  "chap.handoff.decline": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      handoff_id: { type: "string" },
+      reason: { type: "string" },
+      suggested_target: PARTICIPANT_URI
+    },
+    required: ["workspace", "from", "handoff_id"]
+  },
+  // ============================================================
+  //   control/1.0
+  // ============================================================
+  "chap.control.pause": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      scope: { type: "string", enum: ["task", "participant", "workspace"], default: "task" },
+      task_id: TASK_ID,
+      participant_uri: PARTICIPANT_URI,
+      in_flight_policy: { type: "string", enum: ["allow_to_complete", "interrupt"] },
+      reason: { type: "string" }
+    },
+    required: ["workspace", "from"]
+  },
+  "chap.control.resume": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      scope: { type: "string", enum: ["task", "participant", "workspace"], default: "task" },
+      task_id: TASK_ID,
+      participant_uri: PARTICIPANT_URI
+    },
+    required: ["workspace", "from"]
+  },
+  "chap.control.cancel": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      reason: { type: "string" }
+    },
+    required: ["workspace", "from", "task_id"]
+  },
+  "chap.control.snapshot": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      label: { type: "string" },
+      include: { type: "array", items: { type: "string" }, description: "Aspects to snapshot, e.g. ['members', 'open_tasks', 'mode_ceiling']." }
+    },
+    required: ["workspace", "from"]
+  },
+  "chap.control.rollback": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      to_snapshot_artefact_id: { type: "string" },
+      what_to_restore: { type: "array", items: { type: "string" } },
+      reason: { type: "string" }
+    },
+    required: ["workspace", "from", "to_snapshot_artefact_id"]
+  },
+  "chap.control.supersede": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      successor_task: {
+        type: "object",
+        properties: {
+          kind: { type: "string" },
+          assignee: PARTICIPANT_URI,
+          input: { type: "object", additionalProperties: true }
+        },
+        required: ["kind"]
+      },
+      reason: { type: "string" }
+    },
+    required: ["workspace", "from", "task_id", "successor_task"]
+  },
+  "chap.control.set_mode_ceiling": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      new_ceiling: { type: "string", enum: ["shadow", "trial", "production"] },
+      reason: { type: "string" }
+    },
+    required: ["workspace", "from", "new_ceiling"]
+  },
+  // ============================================================
+  //   routing/1.0
+  // ============================================================
+  "chap.task.route": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      candidates: { type: "array", items: PARTICIPANT_URI, description: "Candidate assignees." }
+    },
+    required: ["workspace", "from", "task_id", "candidates"]
+  },
+  "chap.review.depth": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      artefact_routing_hints: {
+        type: "object",
+        description: "Per-artefact signals like confidence, model_id, cost_consumed_usd.",
+        additionalProperties: true
+      }
+    },
+    required: ["workspace", "from", "task_id"]
+  },
+  "chap.escalate.auto": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      task_id: TASK_ID,
+      default_escalation_target: PARTICIPANT_URI
+    },
+    required: ["workspace", "from", "task_id"]
+  },
+  // ============================================================
+  //   security-signed/1.0
+  // ============================================================
+  "chap.participant.rotate_key": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      old_kid: { type: "string" },
+      new_jwk: { type: "object", additionalProperties: true }
+    },
+    required: ["workspace", "from", "old_kid", "new_jwk"]
+  },
+  "chap.participant.revoke_key": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      target_uri: PARTICIPANT_URI,
+      kid: { type: "string" },
+      reason: { type: "string" }
+    },
+    required: ["workspace", "from", "target_uri", "kid"]
+  },
+  // ============================================================
+  //   audit-scitt/1.0
+  // ============================================================
+  "chap.audit.submit_to_scitt": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      range: {
+        type: "object",
+        properties: {
+          from_seq: { type: "integer" },
+          to_seq: { type: "integer" }
+        }
+      },
+      issuer: { type: "string" }
+    },
+    required: ["workspace"]
+  },
+  "chap.audit.verify_receipt": {
+    type: "object",
+    properties: {
+      workspace: WORKSPACE_ID,
+      from: PARTICIPANT_URI,
+      receipt: { type: "object", additionalProperties: true }
+    },
+    required: ["workspace", "receipt"]
+  },
+  "chap.audit.verify_chain": {
+    type: "object",
+    properties: { workspace: WORKSPACE_ID, from: PARTICIPANT_URI },
+    required: ["workspace"]
+  }
+};
+var TOOL_NAMES = Object.keys(SCHEMAS);
+function schemaFor(toolName) {
+  return SCHEMAS[toolName] ?? null;
+}
+function methodForTool(toolName) {
+  if (!toolName.startsWith("chap.")) return null;
+  return toolName.slice("chap.".length);
+}
+function admitsType(schema, t) {
+  if (!schema) return false;
+  if (schema.type === t) return true;
+  if (schema.oneOf) return schema.oneOf.some((s) => admitsType(s, t));
+  if (schema.type === void 0 && !schema.oneOf && !schema.enum) return true;
+  return false;
+}
+function coerceValue(value, schema) {
+  if (typeof value !== "string") return value;
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return value;
+  const looksLikeObject = trimmed.startsWith("{");
+  const looksLikeArray = trimmed.startsWith("[");
+  if (!looksLikeObject && !looksLikeArray) return value;
+  const wantObject = looksLikeObject && admitsType(schema, "object");
+  const wantArray = looksLikeArray && admitsType(schema, "array");
+  if (!wantObject && !wantArray) return value;
+  try {
+    const parsed = JSON.parse(value);
+    if (Array.isArray(parsed) && admitsType(schema, "array")) return parsed;
+    if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) && admitsType(schema, "object")) return parsed;
+    return value;
+  } catch {
+    return value;
+  }
+}
+function coerceToolArgs(toolName, args) {
+  const schema = schemaFor(toolName);
+  const props = schema?.properties;
+  if (!props) return args;
+  const out = {};
+  for (const [key, value] of Object.entries(args)) {
+    out[key] = coerceValue(value, props[key]);
+  }
+  return out;
+}
+export {
+  SCHEMAS,
+  TOOL_NAMES,
+  coerceToolArgs,
+  methodForTool,
+  schemaFor
+};
+//# sourceMappingURL=schemas.js.map