careermate 0.0.3 → 0.0.4

package/packages/shared/src/schemas.ts

@@ -72,8 +72,32 @@ const reqBody = z
   .string()
   .max(MAX_BODY)
   .refine((s) => s.trim().length > 0, { message: EMPTY_MSG });
-/** Bounded array of bounded strings. */
-const strList = z.array(z.string().max(MAX_ITEM)).max(MAX_ITEMS);
+/**
+ * Coerce a stray scalar into a string array. MCP/LLM clients routinely serialize
+ * array arguments as a *string* — a JSON-encoded array (`'["Java","Spring"]'`) or
+ * a comma/newline-separated list (`'Java, Spring'`) — instead of a real array. The
+ * SDK then rejects the whole tool call with "Expected array, received string", so
+ * a single mis-serialized field (keywords, requirements, strengths, tech, tags…)
+ * fails the entire save. Absorb those shapes here; real arrays and non-strings
+ * pass straight through. The emitted JSON schema still advertises `array`, so the
+ * client is still told the correct shape — this only rescues the cases it ignores.
+ */
+function toStrList(v: unknown): unknown {
+  if (typeof v !== 'string') return v;
+  const s = v.trim();
+  if (!s) return [];
+  if (s.startsWith('[')) {
+    try {
+      const parsed = JSON.parse(s);
+      if (Array.isArray(parsed)) return parsed;
+    } catch {
+      /* not valid JSON — fall through to delimiter split */
+    }
+  }
+  return s.split(/[\n,]/).map((x) => x.trim()).filter(Boolean);
+}
+/** Bounded array of bounded strings; tolerant of stringified inputs (see toStrList). */
+const strList = z.preprocess(toStrList, z.array(z.string().max(MAX_ITEM)).max(MAX_ITEMS));
 
 const baseRecord = {
   id,
@@ -151,6 +175,16 @@ export const ExperienceRecordSchema = z.object({
 });
 export type ExperienceRecord = z.infer<typeof ExperienceRecordSchema>;
 
+/** Batch input: add several experiences in one MCP call (one item → array of one). */
+export const ExperienceBatchInputSchema = z.object({
+  experiences: z
+    .array(ExperienceInputSchema)
+    .min(1)
+    .max(MAX_ITEMS)
+    .describe('추가할 경력 목록(한 건이어도 배열로). 같은 회사·직무·입사일은 갱신되고 중복 생성되지 않습니다.'),
+});
+export type ExperienceBatchInput = z.infer<typeof ExperienceBatchInputSchema>;
+
 /* ------------------------------------------------------------------ Project */
 
 export const ProjectInputSchema = z.object({
@@ -180,6 +214,16 @@ export const ProjectRecordSchema = z.object({
 });
 export type ProjectRecord = z.infer<typeof ProjectRecordSchema>;
 
+/** Batch input: add several projects in one MCP call (one item → array of one). */
+export const ProjectBatchInputSchema = z.object({
+  projects: z
+    .array(ProjectInputSchema)
+    .min(1)
+    .max(MAX_ITEMS)
+    .describe('추가할 프로젝트 목록(한 개여도 배열로). 같은 이름의 프로젝트는 갱신되고 중복 생성되지 않습니다.'),
+});
+export type ProjectBatchInput = z.infer<typeof ProjectBatchInputSchema>;
+
 /* -------------------------------------------------------------------- Skill */
 
 export const SkillInputSchema = z.object({
@@ -201,6 +245,16 @@ export const SkillRecordSchema = z.object({
 });
 export type SkillRecord = z.infer<typeof SkillRecordSchema>;
 
+/** Batch input: add several skills in one MCP call (one item → array of one). */
+export const SkillBatchInputSchema = z.object({
+  skills: z
+    .array(SkillInputSchema)
+    .min(1)
+    .max(MAX_ITEMS)
+    .describe('추가할 기술스택 목록(한 개여도 배열로). 같은 이름의 기술은 갱신되고 중복 생성되지 않습니다.'),
+});
+export type SkillBatchInput = z.infer<typeof SkillBatchInputSchema>;
+
 /* ----------------------------------------------------------------- Document */
 
 export const DocumentInputSchema = z.object({

package/packages/workflows/src/definitions.ts

@@ -33,7 +33,7 @@ export const WORKFLOWS: WorkflowDefinition[] = [
       '파일 입력 분기: ① 사용자가 "파일이 있다"고 하면 `open_inbox`로 인입 폴더를 열어 파일을 넣게 하고, "다 넣었다"고 하면 `read_inbox`로 본문을 읽는다(pdf·이미지는 read_inbox가 경로만 주므로 클라이언트의 파일 읽기로 직접 읽는다). ② 사용자가 파일 경로를 직접 알려주면 `read_document`로 읽는다. ③ "없다/직접 입력/텍스트로 붙여넣기"면 폴더를 열지 말고 받은 텍스트를 그대로 쓴다. (묻지도 않고 open_inbox로 폴더를 자동으로 열지 않는다.)',
       '수집한 정보를 구조화해 `save_profile`로 저장한다(이름·연락처·headline·summary·desired_roles·desired_conditions, 그리고 글쓰기 선호인 preferred_tone과 emphasis_points 포함). 파일 출처는 source=upload, 직접 입력은 manual.',
       '업로드한 이력서/경력기술서/포트폴리오 본문을 `add_resume`로 저장한다(kind·title 지정, 대표 문서는 is_primary=true).',
-      '경력·프로젝트·스킬이 파악되면 `add_experience`·`add_project`·`add_skill`로 각각 저장한다(완성도의 has_experience/has_skills에 반영).',
+      '경력·프로젝트·스킬이 파악되면 `add_experience`·`add_project`·`add_skill`로 저장한다 — 각 도구는 배열을 받으므로 파악한 항목을 한 번에 모아 넘긴다(항목마다 반복 호출하지 않는다). 같은 항목을 다시 넣어도 중복 없이 갱신된다(완성도의 has_experience/has_skills에 반영).',
       '기존 자기소개서가 있으면 `save_cover_letter_version`으로 저장한다(title+content면 v1로 저장, 없으면 나중에 작성 가능함을 안내).',
       '`open_dashboard`를 호출해 사용자가 자기 데이터를 확인하게 한다.',
       '다시 `get_onboarding_status`로 완성도를 확인하고, 다음 단계(공고 분석 등)를 제안한다.',