@ttctl/mcp 0.0.0 → 0.1.0-rc.1

package/dist/tools/profile/certifications.js

@@ -0,0 +1,193 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { parseDateInput, profile } from "@ttctl/core";
+import { z } from "zod";
+import { buildMcpDryRunPreview, dryRunResponse } from "../_shared.js";
+import { dateInput, jsonSuccess, presentToolError, textSuccess } from "./shared.js";
+const DRY_RUN_FIELD = z
+    .boolean()
+    .optional()
+    .describe("Preview the request without executing. Returns `{ ok: true, dryRun: true, preview }` with operationName + variables + redacted bearer header. Default: false.");
+/**
+ * Register the five `profile.certifications.*` MCP tools on `server`.
+ *
+ * MCP tool names use ONLY the canonical `certifications` form — the CLI
+ * alias `certs` (per #72) is CLI-only and never appears in the MCP
+ * catalog.
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`. When
+ * `dryRun: true`, returns `{ ok: true, dryRun: true, preview }` via
+ * MCP-layer preview building. `show` previews `GET_CERTIFICATION` (the
+ * apply path lists then filters client-side; no per-id selector exists).
+ * `profileId` carries `DRY_RUN_PROFILE_ID_PLACEHOLDER` where the apply
+ * path resolves it via a sibling profile read.
+ */
+export function registerCertificationsTools(server, ctx) {
+    server.registerTool("ttctl_profile_certifications_add", {
+        title: "Add certification entry",
+        description: "Add a new certification entry (name + issuer, with optional issue / expiration dates, credential URL, and credential ID). Dates accept ISO-8601 (YYYY-MM-DD) or year-only (YYYY); month is preserved when given.",
+        inputSchema: {
+            name: z.string().min(1).describe("certification name (mapped to certificate)"),
+            issuer: z.string().min(1).describe("issuing organization (mapped to institution)"),
+            issued: dateInput.optional().describe("issue date — ISO-8601 or year"),
+            expires: dateInput.optional().describe("expiration date — ISO-8601 or year"),
+            link: z.url().optional().describe("credential URL"),
+            number: z.string().optional().describe("credential ID / certificate number"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.certifications.add");
+        if ("error" in auth)
+            return auth.error;
+        const fields = {
+            certificate: input.name,
+            institution: input.issuer,
+        };
+        try {
+            if (input.issued !== undefined) {
+                const parsed = parseDateInput(input.issued, "issued");
+                fields.validFromMonth = parsed.month;
+                fields.validFromYear = parsed.year;
+            }
+            if (input.expires !== undefined) {
+                const parsed = parseDateInput(input.expires, "expires");
+                fields.validToMonth = parsed.month;
+                fields.validToYear = parsed.year;
+            }
+        }
+        catch (err) {
+            return presentToolError("profile.certifications.add", err);
+        }
+        if (input.link !== undefined)
+            fields.link = input.link;
+        if (input.number !== undefined)
+            fields.number = input.number;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("CREATE_CERTIFICATION", "talent-profile", { input: { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER, certification: fields } }, auth.token));
+        }
+        try {
+            const created = await profile.certifications.add(auth.token, fields);
+            return jsonSuccess(created);
+        }
+        catch (err) {
+            return presentToolError("profile.certifications.add", err);
+        }
+    });
+    server.registerTool("ttctl_profile_certifications_update", {
+        title: "Update certification entry",
+        description: "Update an existing certification entry by id. At least one field must be supplied.",
+        inputSchema: {
+            id: z.string().min(1).describe("certification id (V1-Certification-NNN)"),
+            name: z.string().optional(),
+            issuer: z.string().optional(),
+            issued: dateInput.optional(),
+            expires: dateInput.optional(),
+            link: z.url().optional(),
+            number: z.string().optional(),
+            highlight: z.boolean().optional(),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.certifications.update");
+        if ("error" in auth)
+            return auth.error;
+        const fields = {};
+        try {
+            if (input.issued !== undefined) {
+                const parsed = parseDateInput(input.issued, "issued");
+                fields.validFromMonth = parsed.month;
+                fields.validFromYear = parsed.year;
+            }
+            if (input.expires !== undefined) {
+                const parsed = parseDateInput(input.expires, "expires");
+                fields.validToMonth = parsed.month;
+                fields.validToYear = parsed.year;
+            }
+        }
+        catch (err) {
+            return presentToolError("profile.certifications.update", err);
+        }
+        if (input.name !== undefined)
+            fields.certificate = input.name;
+        if (input.issuer !== undefined)
+            fields.institution = input.issuer;
+        if (input.link !== undefined)
+            fields.link = input.link;
+        if (input.number !== undefined)
+            fields.number = input.number;
+        if (input.highlight !== undefined)
+            fields.highlight = input.highlight;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("UPDATE_CERTIFICATION", "talent-profile", { input: { certificationId: input.id, certification: fields } }, auth.token));
+        }
+        try {
+            const updated = await profile.certifications.update(auth.token, input.id, fields);
+            return jsonSuccess(updated);
+        }
+        catch (err) {
+            return presentToolError("profile.certifications.update", err);
+        }
+    });
+    server.registerTool("ttctl_profile_certifications_remove", {
+        title: "Remove certification entry",
+        description: "Remove a certification entry by id.",
+        inputSchema: { id: z.string().min(1).describe("certification id"), dryRun: DRY_RUN_FIELD },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.certifications.remove");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("REMOVE_CERTIFICATION", "talent-profile", { input: { certificationId: input.id } }, auth.token));
+        }
+        try {
+            const id = await profile.certifications.remove(auth.token, input.id);
+            return textSuccess(`Certification ${id} removed.`);
+        }
+        catch (err) {
+            return presentToolError("profile.certifications.remove", err);
+        }
+    });
+    server.registerTool("ttctl_profile_certifications_show", {
+        title: "Show certification entry",
+        description: "Show a single certification entry by id (returns the row as JSON). Note: the underlying wire call lists all rows and filters client-side; the dry-run preview emits `GET_CERTIFICATION` (the list query) accordingly.",
+        inputSchema: { id: z.string().min(1).describe("certification id"), dryRun: DRY_RUN_FIELD },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.certifications.show");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("GET_CERTIFICATION", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const row = await profile.certifications.show(auth.token, input.id);
+            return jsonSuccess(row);
+        }
+        catch (err) {
+            return presentToolError("profile.certifications.show", err);
+        }
+    });
+    server.registerTool("ttctl_profile_certifications_highlight", {
+        title: "Toggle certification highlight",
+        description: "Toggle the highlight flag on a certification entry.",
+        inputSchema: {
+            id: z.string().min(1).describe("certification id"),
+            highlight: z.boolean().default(true),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.certifications.highlight");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("highlightCertification", "talent-profile", { id: input.id, highlight: input.highlight }, auth.token));
+        }
+        try {
+            const result = await profile.certifications.highlight(auth.token, input.id, input.highlight);
+            return jsonSuccess(result);
+        }
+        catch (err) {
+            return presentToolError("profile.certifications.highlight", err);
+        }
+    });
+}
+//# sourceMappingURL=certifications.js.map

package/dist/tools/profile/certifications.js.map

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

package/dist/tools/profile/education.d.ts

@@ -0,0 +1,23 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "../_shared.js";
+/**
+ * Register the five `profile.education.*` MCP tools on `server`. Mirrors
+ * the CLI surface 1:1 (canonical names — no CLI-only aliases per project
+ * policy in #72).
+ *
+ * Tools:
+ *   - ttctl_profile_education_add
+ *   - ttctl_profile_education_update
+ *   - ttctl_profile_education_remove
+ *   - ttctl_profile_education_show
+ *   - ttctl_profile_education_highlight
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`. When
+ * `dryRun: true`, returns `{ ok: true, dryRun: true, preview }` via
+ * MCP-layer preview building. `show` previews `GET_EDUCATION` (the
+ * apply path lists then filters client-side; no per-id selector exists).
+ * `profileId` carries `DRY_RUN_PROFILE_ID_PLACEHOLDER` where the apply
+ * path resolves it via a sibling profile read.
+ */
+export declare function registerEducationTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=education.d.ts.map

package/dist/tools/profile/education.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"education.d.ts","sourceRoot":"","sources":["../../../src/tools/profile/education.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAWpG;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAyM5F"}

package/dist/tools/profile/education.js

@@ -0,0 +1,196 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { parseDateInput, profile } from "@ttctl/core";
+import { z } from "zod";
+import { buildMcpDryRunPreview, dryRunResponse } from "../_shared.js";
+import { profileEducationRowOutputSchema, profileRowRemoveOutputSchema } from "../output-schemas.js";
+import { dateInput, jsonSuccess, presentToolError, textWithStructuredSuccess } from "./shared.js";
+const DRY_RUN_FIELD = z
+    .boolean()
+    .optional()
+    .describe("Preview the request without executing. Returns `{ ok: true, dryRun: true, preview }` with operationName + variables + redacted bearer header. Default: false.");
+/**
+ * Register the five `profile.education.*` MCP tools on `server`. Mirrors
+ * the CLI surface 1:1 (canonical names — no CLI-only aliases per project
+ * policy in #72).
+ *
+ * Tools:
+ *   - ttctl_profile_education_add
+ *   - ttctl_profile_education_update
+ *   - ttctl_profile_education_remove
+ *   - ttctl_profile_education_show
+ *   - ttctl_profile_education_highlight
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`. When
+ * `dryRun: true`, returns `{ ok: true, dryRun: true, preview }` via
+ * MCP-layer preview building. `show` previews `GET_EDUCATION` (the
+ * apply path lists then filters client-side; no per-id selector exists).
+ * `profileId` carries `DRY_RUN_PROFILE_ID_PLACEHOLDER` where the apply
+ * path resolves it via a sibling profile read.
+ */
+export function registerEducationTools(server, ctx) {
+    server.registerTool("ttctl_profile_education_add", {
+        title: "Add education entry",
+        description: "Add a new education entry (institution + degree, with optional field of study, location, title, and start/end years). Dates accept ISO-8601 (YYYY-MM-DD) or year-only (YYYY).",
+        inputSchema: {
+            institution: z.string().min(1).describe("school / university name"),
+            degree: z.string().min(1).describe("degree (e.g. BSc, MSc, PhD)"),
+            from: dateInput.optional().describe("start date — ISO-8601 or year"),
+            to: dateInput.optional().describe("end date — ISO-8601 or year"),
+            fieldOfStudy: z.string().optional(),
+            location: z.string().optional(),
+            title: z.string().optional(),
+            dryRun: DRY_RUN_FIELD,
+        },
+        outputSchema: profileEducationRowOutputSchema.shape,
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.education.add");
+        if ("error" in auth)
+            return auth.error;
+        const fields = {
+            institution: input.institution,
+            degree: input.degree,
+        };
+        try {
+            if (input.from !== undefined)
+                fields.yearFrom = parseDateInput(input.from, "from").year;
+            if (input.to !== undefined)
+                fields.yearTo = parseDateInput(input.to, "to").year;
+        }
+        catch (err) {
+            return presentToolError("profile.education.add", err);
+        }
+        if (input.fieldOfStudy !== undefined)
+            fields.fieldOfStudy = input.fieldOfStudy;
+        if (input.location !== undefined)
+            fields.location = input.location;
+        if (input.title !== undefined)
+            fields.title = input.title;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("CREATE_EDUCATION", "talent-profile", { input: { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER, education: fields } }, auth.token));
+        }
+        try {
+            const created = await profile.education.add(auth.token, fields);
+            return jsonSuccess(created);
+        }
+        catch (err) {
+            return presentToolError("profile.education.add", err);
+        }
+    });
+    server.registerTool("ttctl_profile_education_update", {
+        title: "Update education entry",
+        description: "Update an existing education entry by id. At least one field must be supplied.",
+        inputSchema: {
+            id: z.string().min(1).describe("education id (V1-Education-NNN)"),
+            institution: z.string().optional(),
+            degree: z.string().optional(),
+            from: dateInput.optional(),
+            to: dateInput.optional(),
+            fieldOfStudy: z.string().optional(),
+            location: z.string().optional(),
+            title: z.string().optional(),
+            highlight: z.boolean().optional(),
+            dryRun: DRY_RUN_FIELD,
+        },
+        outputSchema: profileEducationRowOutputSchema.shape,
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.education.update");
+        if ("error" in auth)
+            return auth.error;
+        const fields = {};
+        try {
+            if (input.from !== undefined)
+                fields.yearFrom = parseDateInput(input.from, "from").year;
+            if (input.to !== undefined)
+                fields.yearTo = parseDateInput(input.to, "to").year;
+        }
+        catch (err) {
+            return presentToolError("profile.education.update", err);
+        }
+        if (input.institution !== undefined)
+            fields.institution = input.institution;
+        if (input.degree !== undefined)
+            fields.degree = input.degree;
+        if (input.fieldOfStudy !== undefined)
+            fields.fieldOfStudy = input.fieldOfStudy;
+        if (input.location !== undefined)
+            fields.location = input.location;
+        if (input.title !== undefined)
+            fields.title = input.title;
+        if (input.highlight !== undefined)
+            fields.highlight = input.highlight;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("UPDATE_EDUCATION", "talent-profile", { input: { educationId: input.id, education: fields } }, auth.token));
+        }
+        try {
+            const updated = await profile.education.update(auth.token, input.id, fields);
+            return jsonSuccess(updated);
+        }
+        catch (err) {
+            return presentToolError("profile.education.update", err);
+        }
+    });
+    server.registerTool("ttctl_profile_education_remove", {
+        title: "Remove education entry",
+        description: "Remove an education entry by id.",
+        inputSchema: { id: z.string().min(1).describe("education id"), dryRun: DRY_RUN_FIELD },
+        outputSchema: profileRowRemoveOutputSchema.shape,
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.education.remove");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("REMOVE_EDUCATION", "talent-profile", { input: { educationId: input.id } }, auth.token));
+        }
+        try {
+            const id = await profile.education.remove(auth.token, input.id);
+            return textWithStructuredSuccess(`Education ${id} removed.`, { id, removed: true });
+        }
+        catch (err) {
+            return presentToolError("profile.education.remove", err);
+        }
+    });
+    server.registerTool("ttctl_profile_education_show", {
+        title: "Show education entry",
+        description: "Show a single education entry by id (returns the row as JSON). Note: the underlying wire call lists all rows and filters client-side; the dry-run preview emits `GET_EDUCATION` (the list query) accordingly.",
+        inputSchema: { id: z.string().min(1).describe("education id"), dryRun: DRY_RUN_FIELD },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.education.show");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("GET_EDUCATION", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const row = await profile.education.show(auth.token, input.id);
+            return jsonSuccess(row);
+        }
+        catch (err) {
+            return presentToolError("profile.education.show", err);
+        }
+    });
+    server.registerTool("ttctl_profile_education_highlight", {
+        title: "Toggle education highlight",
+        description: "Toggle the highlight flag on an education entry.",
+        inputSchema: {
+            id: z.string().min(1).describe("education id"),
+            highlight: z.boolean().default(true).describe("true to highlight, false to un-highlight"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.resolveTokenForTool("profile.education.highlight");
+        if ("error" in auth)
+            return auth.error;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("highlightEducation", "talent-profile", { id: input.id, highlight: input.highlight }, auth.token));
+        }
+        try {
+            const result = await profile.education.highlight(auth.token, input.id, input.highlight);
+            return jsonSuccess(result);
+        }
+        catch (err) {
+            return presentToolError("profile.education.highlight", err);
+        }
+    });
+}
+//# sourceMappingURL=education.js.map

package/dist/tools/profile/education.js.map

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

package/dist/tools/profile/employment.d.ts

@@ -0,0 +1,23 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "../_shared.js";
+/**
+ * Register the six `profile.employment.*` MCP tools on `server`.
+ *
+ * MCP tool names use ONLY the canonical `employment` form — the CLI
+ * alias `experience` (per #72) is CLI-only and never appears in the MCP
+ * catalog.
+ *
+ * The sixth tool (`employer_autocomplete`) is the catalog lookup leaf
+ * — it returns suggestions from the known-employer database, useful
+ * for resolving free-text employer names to canonical Toptal IDs
+ * before adding a new employment row.
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`. When
+ * `dryRun: true`, returns `{ ok: true, dryRun: true, preview }` via
+ * MCP-layer preview building. `show` previews `GET_WORK_EXPERIENCE` (the
+ * apply path lists then filters client-side; no per-id selector exists).
+ * `profileId` carries `DRY_RUN_PROFILE_ID_PLACEHOLDER` where the apply
+ * path resolves it via a sibling profile read.
+ */
+export declare function registerEmploymentTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=employment.d.ts.map

package/dist/tools/profile/employment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"employment.d.ts","sourceRoot":"","sources":["../../../src/tools/profile/employment.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAWpG;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA8P7F"}