@usercase/mcp 0.2.10-next.2 → 0.2.10-next.4

package/README.md

@@ -67,6 +67,14 @@ The number is how many people visit in total (default 5). Above 5, Claude works
 
 With `unlimited` it keeps going until you press Esc. Every visit uses your Claude usage.
 
+### Take part in a research
+
+Give a research id from your dashboard and the people take part in it instead of exploring freely — they accept its invitation and do its tasks from the study panel, the way invited participants do. The research must be live.
+
+```
+/mcp__usercase__research https://staging.example.com 10 research=<research id>
+```
+
 When a visit ends, it is sent to your dashboard (**Visits**). If the upload fails, it is kept in `.usercase/outbox.jsonl` and sent with the next one.
 
 ### Sites behind a sign-in

package/agents/study.md

@@ -6,7 +6,7 @@ The user wants the people to **take part in a research** from their Usercase das
 - If the status is not `deployed`, stop and tell the user: the site only offers deployed researches, so the visitors could not join it. They can deploy it in the dashboard and run this again.
 - If the Usercase SDK is not running on the site, stop — without it there is no research to join.
 
-Show the user the tasks in one short list before casting, so they know what the people will be asked to do.
+Show the user the tasks in one short list before casting, so they know what the people will be asked to do — as information, not as a question. Then go straight on.
 
 **The research decides what the visit is about — do not ask the user about it.** Not what the visitors should try, how far they should go, which tasks to cover or what to focus on: the participants get the research's tasks from the study panel and do what they would do. The only questions for the user are the ones the steps below always ask — demo accounts (if parts of the tasks need sign-in) and whether writes are sent — asked as those questions, in those words, and not merged with anything about the research. A task that needs a sign-in the visitors do not have is still run: what happens to a participant without an account is a result.
 

package/mcp/server.js

@@ -562,9 +562,20 @@ server.registerTool(
     description: "List the tasks of a Usercase research (from the dashboard) and whether each already has an expected path. Call first in the path procedure.",
     inputSchema: { research: z.string().describe("The research id, as shown in the dashboard command") },
   },
-  wrap(async ({ research }) => text(await recorder.tasks(research))),
+  wrap(async ({ research }) => {
+    const out = await recorder.tasks(research);
+    // 리서치에 참여시키는 판(research=<id>)에서 그 리서치를 읽은 것이면 — 과제를 읽은 바로 이 자리에서 못 박는다.
+    // 지시문 중간의 규칙만으로는 "어느 과제까지 시킬까"를 사용자에게 물었다(10/30 라이브 bluetags, 로그인이 필요한 Follow 과제)
+    return text(run && run.research && run.research === String(research).trim() ? `${out}\n\n${STUDY_TASKS_NOTE}` : out);
+  }),
 );
 
+const STUDY_TASKS_NOTE = [
+  "These are the tasks every participant in this run does — all of them, in order, from the study panel, whatever they ask (including tasks that need signing in or sending something). That is fixed by the research and is not the user's choice in this run.",
+  "Do not ask the user which tasks or actions the visitors should do, how far they should go, or what to focus on. Show these tasks to the user as a plain list for their information, then go straight on to casting.",
+  "The only questions for the user are the demo-account and writes questions the instructions give, each asked as its own question in its own words.",
+].join("\n");
+
 server.registerTool(
   "path_start",
   {
@@ -917,6 +928,30 @@ const pathWalkRules = () => {
     .trim();
 };
 
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+/**
+ * 명령 인자를 이름으로 맞춘다. Claude Code 는 /mcp__usercase__research 의 인자를 띄어쓰기로 나눠 순서대로 넘긴다 —
+ * `research=<id>` 라고 써도 세 번째 자리(focus)에 "research=<id>" 로 들어가, 리서치가 아니라 초점 판으로 돌았다(10/30 라이브 bluetags).
+ * 그래서 어느 자리에 있든 `이름=값`(또는 `이름:값`)이면 그 이름으로 옮기고, research 를 받는 명령에서는 이름 없는 리서치 id(UUID)도 research 로 본다
+ */
+function byName(args = {}, schema = {}) {
+  const names = Object.keys(schema || {});
+  const out = {};
+  const loose = [];
+  for (const [k, raw] of Object.entries(args || {})) {
+    if (raw == null) continue;
+    const v = String(raw).trim();
+    const m = v.match(/^([a-z]+)\s*[=:]\s*(.*)$/is);
+    if (m && names.includes(m[1].toLowerCase())) out[m[1].toLowerCase()] = m[2].trim();
+    else if (names.includes("research") && UUID.test(v.replace(/^research\s+/i, ""))) out.research = v.replace(/^research\s+/i, "");
+    else loose.push([k, v]);
+  }
+  // 이름 없이 온 값은 제자리에 — 이름으로 이미 채운 자리는 덮지 않는다
+  for (const [k, v] of loose) if (!(k in out) && v !== "") out[k] = v;
+  return out;
+}
+
 /**
  * 명령 지시문. 따로 쓰면 MCP 프롬프트(/mcp__usercase__research), 플러그인이면 instructions 도구(/usercase:research 스킬이 부른다)로
  * 같은 글이 나간다
@@ -935,7 +970,8 @@ const COMMANDS = {
     },
     body: ({ url, count, focus, research }) => {
       const plan = researchPlan(count);
-      run = { total: plan.total, since: Date.now() };
+      // research — 이 판이 참여하는 리서치. path_tasks 가 그 리서치를 읽을 때 과제를 고르지 말라고 덧붙인다
+      run = { total: plan.total, since: Date.now(), research: (research || "").trim() || null };
       // 사람 만드는 규칙은 우리 AI 로 만들 때와 같은 원본(people.md)에서 가져온다 — 두 벌로 두지 않는다.
       // 자유 탐방이라 원본이 말하는 "path" 는 "자기 목적으로 왔다" 뿐이다
       const rules =
@@ -1031,12 +1067,12 @@ if (PLUGIN || CODEX || OTHER) {
         ...COMMANDS.steps.argsSchema,
       },
     },
-    wrap(async ({ command, ...args }) => text(COMMANDS[command].body(args))),
+    wrap(async ({ command, ...args }) => text(COMMANDS[command].body(byName(args, COMMANDS[command].argsSchema)))),
   );
 } else {
   for (const [name, c] of Object.entries(COMMANDS)) {
     const meta = c.argsSchema ? { description: c.description, argsSchema: c.argsSchema } : { description: c.description };
-    server.registerPrompt(name, meta, (args = {}) => ({ messages: [{ role: "user", content: { type: "text", text: c.body(args) } }] }));
+    server.registerPrompt(name, meta, (args = {}) => ({ messages: [{ role: "user", content: { type: "text", text: c.body(byName(args, c.argsSchema)) } }] }));
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usercase/mcp",
-  "version": "0.2.10-next.2",
+  "version": "0.2.10-next.4",
   "description": "Virtual users that browse your website and tell you what they thought — an MCP server for Claude Code",
   "license": "UNLICENSED",
   "homepage": "https://usercase.io",