formbro-mcp-server 1.0.0 → 1.0.2

package/dist/tools/patch.js

@@ -0,0 +1,276 @@
+import { z } from "zod";
+import { makeApiRequest, handleApiError } from "../services/api-client.js";
+import { getProgramLookupKeys } from "./program-keys.js";
+// ============================================================================
+// Input Schemas
+// ============================================================================
+const PatchPersonSchema = z.object({
+    person_id: z.string().describe("Person (applicant) MongoDB ObjectId."),
+    updates: z.record(z.unknown()).describe("Partial update dict matching the applicant model fields. " +
+        "Use dot-notation keys for nested fields (e.g. personal.first_name)."),
+    expected_version: z.number().optional().describe("Optimistic locking version. Include to prevent overwriting concurrent changes."),
+}).strict();
+const PatchApplicationCaseSchema = z.object({
+    application_id: z.string().describe("Application MongoDB ObjectId."),
+    program_key: z.string().describe("Program key — used to route to the correct PATCH endpoint."),
+    updates: z.record(z.unknown()).describe("Partial update dict. Keys must match the application model fields."),
+    expected_version: z.number().optional().describe("Optimistic locking version."),
+}).strict();
+const PatchEmployerSchema = z.object({
+    employer_id: z.string().describe("LMIA employer MongoDB ObjectId."),
+    updates: z.record(z.unknown()).describe("Partial update dict matching the LMIAEmployer model fields."),
+}).strict();
+const AddNoteSchema = z.object({
+    entity_id: z.string().describe("Entity MongoDB ObjectId."),
+    entity_type: z.enum(["applicant", "application", "employer"]).describe("Entity type to add a note to."),
+    note: z.string().describe("Note text to append."),
+}).strict();
+const ValidatePersonForProgramSchema = z.object({
+    person_id: z.string().describe("Applicant MongoDB ObjectId."),
+    program_key: z.string().describe("Program key to validate against."),
+    role: z.string().describe("Role within the program (applicant|spouse|sponsor|employer etc)."),
+}).strict();
+// ============================================================================
+// Helpers
+// ============================================================================
+async function getFormIdForRole(program_key, role) {
+    try {
+        for (const lookupKey of getProgramLookupKeys(program_key)) {
+            try {
+                const prog = await makeApiRequest(`/api/programs/${encodeURIComponent(lookupKey)}`, "GET");
+                const formId = prog.form_ids?.[role] ?? prog.form_ids?.applicant ?? null;
+                if (formId)
+                    return formId;
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function getProgramInfo(program_key) {
+    for (const lookupKey of getProgramLookupKeys(program_key)) {
+        try {
+            const prog = await makeApiRequest(`/api/programs/${encodeURIComponent(lookupKey)}`, "GET");
+            if (prog.api_endpoint && prog.category) {
+                return {
+                    api_endpoint: prog.api_endpoint,
+                    category: prog.category,
+                    form_ids: prog.form_ids,
+                };
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+export function buildApplicationPatchUrl(api_endpoint, category, application_id) {
+    // LMIA: /api/lmia/{stream}/applications/{id}
+    // TR/PR: /api/tr|pr/{endpoint}/{id}
+    if (category === "LMIA") {
+        return `${api_endpoint}/applications/${encodeURIComponent(application_id)}`;
+    }
+    return `${api_endpoint}/${encodeURIComponent(application_id)}`;
+}
+export function expandDotNotation(updates) {
+    const expanded = {};
+    for (const [key, value] of Object.entries(updates)) {
+        if (!key.includes(".")) {
+            expanded[key] = value;
+            continue;
+        }
+        const parts = key.split(".").filter(Boolean);
+        if (parts.length === 0)
+            continue;
+        let cursor = expanded;
+        for (const part of parts.slice(0, -1)) {
+            const existing = cursor[part];
+            if (!existing || typeof existing !== "object" || Array.isArray(existing)) {
+                cursor[part] = {};
+            }
+            cursor = cursor[part];
+        }
+        cursor[parts[parts.length - 1]] = value;
+    }
+    return expanded;
+}
+/** Look up the PATCH URL for an application by matching its program_name against /api/programs. */
+async function getApplicationPatchUrl(application_id) {
+    try {
+        const app = await makeApiRequest(`/api/applications/${encodeURIComponent(application_id)}`, "GET");
+        if (!app.program_name)
+            return null;
+        const programs = await makeApiRequest("/api/programs", "GET");
+        for (const prog of Object.values(programs)) {
+            if (prog.db_name === app.program_name && prog.api_endpoint && prog.category) {
+                return buildApplicationPatchUrl(prog.api_endpoint, prog.category, application_id);
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Tool Registration
+// ============================================================================
+export function registerPatchTools(server) {
+    // 1. patch_person
+    server.registerTool("patch_person", {
+        title: "Patch Person (Applicant)",
+        description: "Partially update an applicant's data. Sends only the provided fields — other fields are unchanged. " +
+            "Provide expected_version to use optimistic locking (recommended when multiple agents may edit). " +
+            "Returns the updated applicant object.",
+        inputSchema: PatchPersonSchema.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async ({ person_id, updates, expected_version }) => {
+        try {
+            const params = { skip_validation: false };
+            if (expected_version !== undefined) {
+                params.if_match = expected_version;
+            }
+            const url = `/api/applicants/${encodeURIComponent(person_id)}`;
+            const data = await makeApiRequest(url, "PATCH", expandDotNotation(updates), {
+                ...params,
+                skip_validation: true,
+            });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+    // 2. patch_application_case
+    server.registerTool("patch_application_case", {
+        title: "Patch Application / Case",
+        description: "Partially update an application or LMIA case. " +
+            "Dispatches to the unified applications PATCH endpoint. " +
+            "Optionally include expected_version for optimistic locking. " +
+            "Returns the updated application object.",
+        inputSchema: PatchApplicationCaseSchema.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async ({ application_id, program_key, updates, expected_version }) => {
+        try {
+            const progInfo = await getProgramInfo(program_key);
+            if (!progInfo) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Error: Unknown program_key '${program_key}'. Use list_programs to find valid keys.` }],
+                };
+            }
+            const params = { skip_validation: true };
+            if (expected_version !== undefined) {
+                params.if_match = expected_version;
+            }
+            const url = buildApplicationPatchUrl(progInfo.api_endpoint, progInfo.category, application_id);
+            const data = await makeApiRequest(url, "PATCH", updates, params);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+    // 3. patch_employer
+    server.registerTool("patch_employer", {
+        title: "Patch LMIA Employer",
+        description: "Partially update an LMIA employer record. " +
+            "Only the provided fields are updated. " +
+            "Returns the updated employer object.",
+        inputSchema: PatchEmployerSchema.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async ({ employer_id, updates }) => {
+        try {
+            const url = `/api/lmia/employers/${encodeURIComponent(employer_id)}`;
+            const data = await makeApiRequest(url, "PATCH", updates);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+    // 4. add_note
+    server.registerTool("add_note", {
+        title: "Add Note to Entity",
+        description: "Append a text note to an applicant, application, or employer. " +
+            "Uses PATCH to add the note to the entity's notes array. " +
+            "Returns the updated entity.",
+        inputSchema: AddNoteSchema.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async ({ entity_id, entity_type, note }) => {
+        try {
+            // Backend's `notes` field is a string (not array). Read current value
+            // and append the new note with a timestamp separator.
+            let getUrl;
+            let patchUrl;
+            let patchParams;
+            if (entity_type === "applicant") {
+                getUrl = `/api/applicants/${encodeURIComponent(entity_id)}`;
+                patchUrl = getUrl;
+                patchParams = { skip_validation: true };
+            }
+            else if (entity_type === "application") {
+                getUrl = `/api/applications/${encodeURIComponent(entity_id)}`;
+                const appPatchUrl = await getApplicationPatchUrl(entity_id);
+                if (!appPatchUrl) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: `Error: Could not resolve PATCH URL for application '${entity_id}'. Ensure the application exists.` }],
+                    };
+                }
+                patchUrl = appPatchUrl;
+                patchParams = { skip_validation: true };
+            }
+            else if (entity_type === "employer") {
+                getUrl = `/api/lmia/employers/${encodeURIComponent(entity_id)}`;
+                patchUrl = getUrl;
+            }
+            else {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Error: Unknown entity_type '${entity_type}'.` }],
+                };
+            }
+            const current = await makeApiRequest(getUrl, "GET");
+            const timestamp = new Date().toISOString();
+            const newNote = `[${timestamp}] ${note}`;
+            const combinedNotes = current.notes ? `${current.notes}\n${newNote}` : newNote;
+            const data = await makeApiRequest(patchUrl, "PATCH", { notes: combinedNotes }, patchParams);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+    // 5. validate_person_for_program
+    server.registerTool("validate_person_for_program", {
+        title: "Validate Person for Program",
+        description: "Run validation on a saved applicant for a specific program and role. " +
+            "Returns validation errors with field paths, error types, and fix suggestions. " +
+            "Use after editing a person to confirm they are ready for form filling.",
+        inputSchema: ValidatePersonForProgramSchema.shape,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async ({ person_id, program_key, role }) => {
+        try {
+            const form_id = await getFormIdForRole(program_key, role);
+            if (!form_id) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Unknown program_key '${program_key}' or role '${role}'. Use list_programs to find valid program keys and roles.` }],
+                };
+            }
+            const data = await makeApiRequest(`/api/validate/${encodeURIComponent(form_id)}/${encodeURIComponent(person_id)}`, "POST", {});
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=patch.js.map

package/dist/tools/patch.js.map

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

package/dist/tools/program-keys.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeProgramKey(programKey: string): string;
+export declare function getProgramLookupKeys(programKey: string): string[];
+//# sourceMappingURL=program-keys.d.ts.map

package/dist/tools/program-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-keys.d.ts","sourceRoot":"","sources":["../../src/tools/program-keys.ts"],"names":[],"mappings":"AAKA,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAGjE"}

package/dist/tools/program-keys.js

@@ -0,0 +1,13 @@
+const PROGRAM_KEY_ALIASES = {
+    pgp: "parent-sponsorship",
+    sps: "spouse-sponsorship",
+};
+export function normalizeProgramKey(programKey) {
+    const key = programKey.trim().toLowerCase();
+    return PROGRAM_KEY_ALIASES[key] ?? programKey;
+}
+export function getProgramLookupKeys(programKey) {
+    const normalized = normalizeProgramKey(programKey);
+    return normalized === programKey ? [programKey] : [programKey, normalized];
+}
+//# sourceMappingURL=program-keys.js.map

package/dist/tools/program-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-keys.js","sourceRoot":"","sources":["../../src/tools/program-keys.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAA2B;IAClD,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,oBAAoB;CAC1B,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,mBAAmB,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACnD,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAC7E,CAAC"}

package/dist/tools/system.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSystemTools(server: McpServer): void;
+//# sourceMappingURL=system.d.ts.map

package/dist/tools/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+F3D"}

package/dist/tools/system.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import { makeApiRequest, handleApiError } from "../services/api-client.js";
+import { normalizeProgramKey } from "./program-keys.js";
+const EmptySchema = z.object({}).strict();
+const ProgramKeySchema = z.object({
+    program_key: z.string().describe("Program key e.g. 'spouse-sponsorship', 'sp-out', 'lws'"),
+}).strict();
+const SchemaQuerySchema = z.object({
+    program_key: z.string(),
+    role: z.enum(["applicant", "spouse", "dependent", "sponsor", "co_signer", "employer"]),
+}).strict();
+export function registerSystemTools(server) {
+    server.registerTool("list_programs", {
+        title: "List FormBro Programs",
+        description: "List all 16 FormBro programs (TR/PR/LMIA). Returns program_key, display_name, category, person_roles, form_ids, api_endpoint. Call first to discover available programs.",
+        inputSchema: EmptySchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async () => {
+        try {
+            const data = await makeApiRequest("/api/programs", "GET");
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+    server.registerTool("describe_program", {
+        title: "Describe a FormBro Program",
+        description: "Get one program's full metadata by program_key. Returns person_roles (which entities are required/optional), form_ids, api_endpoint. Call before quick_create_person to know which roles are needed.",
+        inputSchema: ProgramKeySchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ program_key }) => {
+        try {
+            const data = await makeApiRequest(`/api/programs/${encodeURIComponent(normalizeProgramKey(program_key))}`, "GET");
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+    server.registerTool("describe_person_schema", {
+        title: "Get JSON Schema for Program Role",
+        description: "Get JSON Schema for a (program_key, role) pair — shows exactly which fields are required/optional. Use before quick_create_person.",
+        inputSchema: SchemaQuerySchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ program_key, role }) => {
+        try {
+            const data = await makeApiRequest(`/api/programs/${encodeURIComponent(normalizeProgramKey(program_key))}/schema`, "GET", undefined, { role });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+    server.registerTool("whoami", {
+        title: "Who Am I",
+        description: "Identify the current authenticated user/token: returns user_id, scopes, plan. Use to verify token works before further operations.",
+        inputSchema: EmptySchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async () => {
+        try {
+            const data = await makeApiRequest("/api/auth/whoami", "GET");
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+    server.registerTool("health", {
+        title: "FormBro Health Check",
+        description: "Check FormBro service health (api_version, db_status, build_sha).",
+        inputSchema: EmptySchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async () => {
+        try {
+            const data = await makeApiRequest("/health", "GET");
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=system.js.map

package/dist/tools/system.js.map

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

package/dist/tools/validate.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerValidateTools(server: McpServer): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/tools/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/tools/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2D7D"}

package/dist/tools/validate.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { makeApiRequest, handleApiError } from "../services/api-client.js";
+const ValidateDataSchema = z.object({
+    entity_type: z.string().describe("Form ID e.g. 'tr-sp-out-applicant', 'pr-spouse-sponsorship-applicant'"),
+    data: z.record(z.unknown()).describe("Entity data to validate"),
+    tab: z.string().optional().describe("Validate only a specific tab"),
+}).strict();
+const ValidateByIdSchema = z.object({
+    entity_type: z.string().describe("Form ID e.g. 'tr-visa-out-applicant', 'pr-general-applicant', 'lmia-employer'. Use list_programs to find the correct form_id."),
+    entity_id: z.string().describe("MongoDB ObjectId of the entity"),
+    tab: z.string().optional(),
+}).strict();
+const ValidateOperationSchema = z.object({
+    operation: z.enum(["fill_webform", "fill_webform_tr", "generate_pdf", "generate_pdf_tr", "make_appendix", "fill_supplementary_pdfs"]),
+    entity_type: z.string().describe("Form ID for the entity"),
+    entity_id: z.string().optional(),
+    entity_data: z.record(z.unknown()).optional(),
+}).strict();
+export function registerValidateTools(server) {
+    server.registerTool("validate_entity_data", {
+        title: "Validate Entity Data",
+        description: "Validate unsaved entity data (no DB lookup). Returns errors with field path, type, and source.",
+        inputSchema: ValidateDataSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async ({ entity_type, data, tab }) => {
+        try {
+            const url = tab
+                ? `/api/validate/${encodeURIComponent(entity_type)}?tab=${encodeURIComponent(tab)}`
+                : `/api/validate/${encodeURIComponent(entity_type)}`;
+            const result = await makeApiRequest(url, "POST", data);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+    server.registerTool("validate_entity_by_id", {
+        title: "Validate Entity by ID",
+        description: "Validate an entity loaded from DB by ID. Use after PATCH or to check current state.",
+        inputSchema: ValidateByIdSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async ({ entity_type, entity_id, tab }) => {
+        try {
+            const base = `/api/validate/${encodeURIComponent(entity_type)}/${encodeURIComponent(entity_id)}`;
+            const url = tab ? `${base}?tab=${encodeURIComponent(tab)}` : base;
+            const result = await makeApiRequest(url, "POST", {});
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+    server.registerTool("validate_for_operation", {
+        title: "Validate for Operation",
+        description: "Check prerequisites for fill_webform, generate_pdf, etc. before triggering the operation. Returns validation errors and missing prerequisites.",
+        inputSchema: ValidateOperationSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const result = await makeApiRequest("/api/validate/operation", "POST", args);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: "text", text: handleApiError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/tools/validate.js.map

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

package/dist/tools/write.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function buildStartApplicationBody(applicant_id?: string): Record<string, unknown>;
+export declare function registerWriteTools(server: McpServer): void;
+//# sourceMappingURL=write.d.ts.map

package/dist/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmIpE,wBAAgB,yBAAyB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGxF;AA6RD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgf1D"}