@mcp-gen-ui/core 0.2.0

package/dist/tool-service.js

@@ -0,0 +1,140 @@
+import { ApplicationGuideResponseSchema, BenefitSearchRequestSchema, BenefitSearchResponseSchema, ChangeLogResponseSchema, ChecklistResponseSchema, UpcomingDeadlinesRequestSchema, UpcomingDeadlinesResponseSchema } from "@mcp-gen-ui/schema";
+import { recommendBenefits } from "./recommender.js";
+import { defaultPersonaRegistry, listPersonaPresets } from "./personas.js";
+export const NON_ELIGIBILITY_DISCLAIMER = "Recommendations are candidates, not eligibility decisions, and users must verify final requirements on the official source.";
+/**
+ * Transport-neutral entry point for the gateway tools. The MCP server (or any
+ * other transport) calls these methods; there is no LLM here — orchestration is
+ * the host's responsibility. Every input and output is validated against the
+ * shared Zod contracts.
+ */
+export class BenefitToolService {
+    repository;
+    snapshots;
+    personas;
+    constructor(repository, snapshots, options = {}) {
+        this.repository = repository;
+        this.snapshots = snapshots;
+        this.personas = options.personas ?? defaultPersonaRegistry;
+    }
+    async listPersonas() {
+        return listPersonaPresets(this.personas);
+    }
+    async searchBenefits(input) {
+        const request = BenefitSearchRequestSchema.parse(input);
+        const benefits = await this.repository.search();
+        const results = recommendBenefits(benefits, request, { personas: this.personas });
+        this.recordSnapshots(benefits);
+        return BenefitSearchResponseSchema.parse({
+            query: request.query,
+            profile: request.profile,
+            results,
+            generatedAt: new Date().toISOString()
+        });
+    }
+    async getBenefitDetail(id) {
+        const benefit = await this.repository.getById(id);
+        if (!benefit) {
+            throw new Error(`Benefit not found: ${id}`);
+        }
+        this.snapshots?.recordBenefitSnapshot(benefit);
+        return benefit;
+    }
+    async getUpcomingDeadlines(input) {
+        const request = UpcomingDeadlinesRequestSchema.parse(input ?? {});
+        const benefits = await this.repository.search();
+        const now = Date.now();
+        const maxDeadline = request.withinDays === undefined
+            ? undefined
+            : now + request.withinDays * 24 * 60 * 60 * 1000;
+        const recommended = recommendBenefits(benefits, {
+            query: "혜택 지원 신청 마감",
+            profile: request.profile,
+            weights: { query: 0 }
+        }, { personas: this.personas });
+        const recommendationById = new Map(recommended.map((summary) => [summary.id, summary]));
+        const results = benefits
+            .filter((benefit) => benefit.applicationDeadline)
+            .map((benefit) => ({
+            benefit,
+            deadlineTime: Date.parse(benefit.applicationDeadline),
+            recommendation: recommendationById.get(benefit.id)
+        }))
+            .filter(({ deadlineTime, recommendation }) => Number.isFinite(deadlineTime) &&
+            deadlineTime >= now &&
+            (maxDeadline === undefined || deadlineTime <= maxDeadline) &&
+            recommendation?.status !== "not_applicable")
+            .sort((a, b) => a.deadlineTime - b.deadlineTime)
+            .map(({ benefit, recommendation }) => ({
+            id: benefit.id,
+            title: benefit.title,
+            provider: benefit.provider,
+            category: benefit.category,
+            summary: benefit.summary,
+            status: recommendation?.status ?? "needs_more_info",
+            score: recommendation?.score ?? 0,
+            scoreBreakdown: recommendation?.scoreBreakdown ?? [],
+            reasons: recommendation?.reasons ?? [],
+            missingInfo: recommendation?.missingInfo ?? [],
+            applicationDeadline: benefit.applicationDeadline
+        }));
+        this.recordSnapshots(benefits);
+        return UpcomingDeadlinesResponseSchema.parse({
+            profile: request.profile,
+            withinDays: request.withinDays,
+            results,
+            generatedAt: new Date().toISOString()
+        });
+    }
+    async buildChecklist(benefitId) {
+        const benefit = await this.getBenefitDetail(benefitId);
+        return ChecklistResponseSchema.parse({
+            benefitId,
+            items: benefit.documents,
+            caveats: [NON_ELIGIBILITY_DISCLAIMER]
+        });
+    }
+    async getApplicationGuide(benefitId) {
+        const benefit = await this.getBenefitDetail(benefitId);
+        return ApplicationGuideResponseSchema.parse({
+            benefitId,
+            steps: [
+                {
+                    order: 1,
+                    title: "대상 조건 확인",
+                    description: `${benefit.target} 조건과 본인의 비식별 조건이 맞는지 확인합니다.`,
+                    requiresUserAction: true
+                },
+                {
+                    order: 2,
+                    title: "준비물 확인",
+                    description: "필수 서류와 추가 확인 조건을 체크리스트로 점검합니다.",
+                    requiresUserAction: true
+                },
+                {
+                    order: 3,
+                    title: "공식 신청 경로 이동",
+                    description: benefit.applicationUrl
+                        ? `공식 신청 경로에서 직접 로그인하고 신청합니다: ${benefit.applicationUrl}`
+                        : "공식 안내 페이지에서 최신 신청 경로를 확인합니다.",
+                    requiresUserAction: true
+                }
+            ],
+            safetyNotice: "MCP 서버는 로그인, 본인인증, 민감정보 입력, 제출을 대신 수행하지 않습니다."
+        });
+    }
+    async getChangeLog(entityId) {
+        return ChangeLogResponseSchema.parse({
+            entityId,
+            entries: this.snapshots?.getChangeLog(entityId) ?? []
+        });
+    }
+    recordSnapshots(benefits) {
+        if (!this.snapshots)
+            return;
+        for (const benefit of benefits) {
+            this.snapshots.recordBenefitSnapshot(benefit);
+        }
+    }
+}
+//# sourceMappingURL=tool-service.js.map

package/dist/tool-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-service.js","sourceRoot":"","sources":["../src/tool-service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mcp-gen-ui/core",
+  "version": "0.2.0",
+  "description": "Transport-neutral public-benefit repository, recommender, and tool service for mcp-gen-ui.",
+  "license": "Apache-2.0",
+  "author": "Team KOI",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orca-svg/mcp-gateway-genui.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/orca-svg/mcp-gateway-genui#readme",
+  "bugs": {
+    "url": "https://github.com/orca-svg/mcp-gateway-genui/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "sideEffects": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@mcp-gen-ui/schema": "0.2.0"
+  },
+  "scripts": {
+    "prebuild": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}