ynosis-agent-mcp 0.2.0 → 0.2.1

package/README.md

@@ -35,10 +35,13 @@ Ynosis Agent API 用の **MCP（stdio）**。Cursor など Node がある環境
 ## 施設登録フロー（Python MCP と同一）
 
 ```
-find_existing_facility → update_facility（既存）
+find_existing_facility → update_facility（既存・認定・タグ不足時も編集依頼）
                       → resolve_place_candidates → prepare_facility_for_register → register_facility（新規）
+誤登録整理: remediate_duplicate_facility（正規へ依頼 + withdraw）
 ```
 
+主要ツール: `find_existing_facility`, `prepare_facility_for_register`, `resolve_place_candidates`, `withdraw_facility`, `remediate_duplicate_facility`, `get_tag_options`
+
 ## 運営: npm 公開
 
 リポジトリ内手順: [docs/agent/publishing.md](../../docs/agent/publishing.md#npmynosis-agent-mcp)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ynosis-agent-mcp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "scripts": {
     "test": "node --test test/*.test.mjs"
   },

package/src/client.mjs

@@ -106,6 +106,16 @@ export class AgentApiClient {
     return findExisting(this, name, prefecture, options);
   }
 
+  async withdrawFacility(facilityId) {
+    const res = await this.request("POST", `/api/agent/facilities/${facilityId}/withdraw`);
+    return res.json;
+  }
+
+  async remediateDuplicateFacility(duplicateId, { canonicalId = null, dryRun = false } = {}) {
+    const { remediateDuplicateFacility: remediate } = await import("./facility_remediate.mjs");
+    return remediate(this, duplicateId, { canonicalId, dryRun });
+  }
+
   async prepareFacilityPayload(payload, { place = null, maxResults = 5 } = {}) {
     const { filterValidTags, resolvePlaceForPayload } = await import("./facility_prepare.mjs");
     const prepared = { ...payload };

package/src/facility_remediate.mjs

@@ -0,0 +1,102 @@
+/** Agent 重複誤登録の整理（Python ynosis_agent.facility_remediate と同期）。 */
+
+import { MATCH_SCORE_MIN, facilitySearchQueries, scoreFacilityItem } from "./facility_match.mjs";
+import { mergeFacilityUpdates } from "./facility_prepare.mjs";
+
+function appendNote(existing, line) {
+  const base = String(existing || "").trim();
+  if (base.includes(line)) return base;
+  return base ? `${base}\n${line}` : line;
+}
+
+export async function findCanonicalFacility(client, duplicate, { searchLimit = 30 } = {}) {
+  const dupId = Number(duplicate.id);
+  const name = String(duplicate.name || "").trim();
+  const prefecture = duplicate.prefecture;
+  if (!name) return null;
+
+  let bestScore = 0;
+  let bestItem = null;
+  const queries = facilitySearchQueries(name);
+
+  for (const q of queries) {
+    const params = { q, limit: searchLimit };
+    if (prefecture) params.prefecture = prefecture;
+    let res;
+    try {
+      res = await client.searchFacilities(params);
+    } catch {
+      continue;
+    }
+    for (const item of res.items || []) {
+      if (Number(item.id) === dupId) continue;
+      if (prefecture && (item.prefecture || "") !== prefecture) continue;
+      const sc = await scoreFacilityItem(name, item);
+      if (sc > bestScore) {
+        bestScore = sc;
+        bestItem = item;
+      }
+    }
+  }
+
+  if (bestScore < MATCH_SCORE_MIN || !bestItem) return null;
+  return bestItem;
+}
+
+export async function remediateDuplicateFacility(
+  client,
+  duplicateId,
+  { canonicalId = null, dryRun = false } = {}
+) {
+  const duplicate = await client.getFacility(duplicateId);
+  if (duplicate.is_agent_approved) {
+    return { ok: false, error: "承認済みのため取り下げ不可", duplicate_id: duplicateId };
+  }
+
+  let canonical = canonicalId != null ? await client.getFacility(canonicalId) : await findCanonicalFacility(client, duplicate);
+  if (!canonical) {
+    return {
+      ok: false,
+      action: "no_canonical",
+      duplicate_id: duplicateId,
+      duplicate_name: duplicate.name,
+    };
+  }
+
+  const canonId = Number(canonical.id);
+  canonical = await client.getFacility(canonId);
+  const marker =
+    `[Agent重複整理] 未承認ID ${duplicateId}「${duplicate.name}」は` +
+    ` 当施設（ID ${canonId}）と同一の誤登録。Agent 側で取り下げ${dryRun ? "予定" : "済み"}。`;
+  const proposed = { ...duplicate, notes: appendNote(canonical.notes, marker) };
+  const updates = mergeFacilityUpdates(canonical, proposed) || {};
+  if (proposed.notes !== canonical.notes) updates.notes = proposed.notes;
+
+  const result = {
+    ok: true,
+    action: "remediate",
+    duplicate_id: duplicateId,
+    duplicate_name: duplicate.name,
+    canonical_id: canonId,
+    canonical_name: canonical.name,
+    updates,
+    dry_run: dryRun,
+  };
+
+  if (dryRun) return result;
+
+  let editRequestId = null;
+  if (!Object.keys(updates).length) {
+    result.warning = "正規施設への追記差分なし（認定・タグは既に付与済みの可能性）";
+  } else {
+    const resp = await client.updateFacility(canonId, updates);
+    editRequestId = resp.edit_request_id;
+    if (!editRequestId) {
+      result.warning = "編集依頼が作成されなかった（差分なし扱い）";
+    }
+  }
+  const withdraw = await client.withdrawFacility(duplicateId);
+  result.edit_request_id = editRequestId;
+  result.withdraw = withdraw;
+  return result;
+}

package/src/server.mjs

@@ -29,7 +29,7 @@ function textResult(text) {
 
 const server = new McpServer({
   name: "ynosis-agent",
-  version: "0.2.0",
+  version: "0.2.1",
   instructions:
     "Ynosis（温泉データベース）への施設・成分表登録・検索用ツール。" +
     "新規施設登録前: find_existing_facility で重複確認 → 既存なら update_facility、" +
@@ -88,6 +88,43 @@ server.tool(
   }
 );
 
+server.tool(
+  "withdraw_facility",
+  "未承認 Agent 新規施設を取り下げ（削除）。重複誤登録の整理用。",
+  { facility_id: z.number() },
+  async ({ facility_id }) => {
+    try {
+      return textResult(dump(await client().withdrawFacility(facility_id)));
+    } catch (e) {
+      return textResult(errText(e));
+    }
+  }
+);
+
+server.tool(
+  "remediate_duplicate_facility",
+  "正規施設へ編集依頼（備考に重複整理メモ）→ 誤登録を withdraw。",
+  {
+    duplicate_id: z.number(),
+    canonical_id: z.number().optional(),
+    dry_run: z.boolean().optional(),
+  },
+  async ({ duplicate_id, canonical_id, dry_run }) => {
+    try {
+      return textResult(
+        dump(
+          await client().remediateDuplicateFacility(duplicate_id, {
+            canonicalId: canonical_id ?? null,
+            dryRun: dry_run ?? false,
+          })
+        )
+      );
+    } catch (e) {
+      return textResult(errText(e));
+    }
+  }
+);
+
 server.tool(
   "find_existing_facility",
   "登録前に既存施設を照合（未承認含む）。ヒット時は update_facility、無ければ新規 register_facility。",