@ttctl/mcp 0.0.0 → 0.1.0-rc.2

package/dist/tools/profile_external_recommendations.js

@@ -0,0 +1,57 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../errors.js";
+import { buildMcpDryRunPreview, domainErrorResponse, dryRunResponse, genericErrorResponse, isToolErrorResponse, jsonResponse, } from "./_shared.js";
+const TOOL_NAME = "ttctl_profile_external_recommendations";
+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 `ttctl_profile_external_recommendations` MCP tool. Mirrors
+ * the `ttctl profile external recommendations` CLI leaf — lists the
+ * platform's "do this next" recommendations.
+ *
+ * Each recommendation has a discriminator `type` (e.g.
+ * `EmploymentsCountRecommendation`, `ProfileFreshnessRecommendation`)
+ * and a small payload of variant-specific scalar fields. Nested entity
+ * lists are intentionally trimmed at the GraphQL level — drilling in
+ * requires fetching the underlying domain directly.
+ */
+export function registerProfileExternalRecommendationsTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "List profile recommendations",
+        description: [
+            "List the platform's per-section 'do this next' recommendations for the signed-in talent. Each recommendation has a `type` discriminator and a small payload of scalar fields.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "What does Toptal recommend I improve on my profile?"',
+            '  - "What\'s next on my profile checklist?"',
+            '  - "Show me the recommendations for my profile."',
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("getProfileRecommendations", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const result = await profile.external.recommendations(auth.token);
+            return jsonResponse(result);
+        }
+        catch (err) {
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            if (err instanceof profile.external.ProfileError) {
+                return domainErrorResponse(TOOL_NAME, err);
+            }
+            return genericErrorResponse(TOOL_NAME, err);
+        }
+    });
+}
+//# sourceMappingURL=profile_external_recommendations.js.map

package/dist/tools/profile_external_recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_external_recommendations.js","sourceRoot":"","sources":["../../src/tools/profile_external_recommendations.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,GAEb,MAAM,cAAc,CAAC;AAEtB,MAAM,SAAS,GAAG,wCAAwC,CAAC;AAE3D,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0CAA0C,CAAC,MAAiB,EAAE,GAA4B;IACxG,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE;YACX,+KAA+K;YAC/K,EAAE;YACF,oDAAoD;YACpD,2DAA2D;YAC3D,6CAA6C;YAC7C,mDAAmD;SACpD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;KACvC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,mBAAmB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,cAAc,CACnB,qBAAqB,CACnB,2BAA2B,EAC3B,gBAAgB,EAChB,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAC3D,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC;YAClD,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACjC,IAAI,GAAG,YAAY,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;gBACjD,OAAO,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,oBAAoB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/profile_external_show.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_profile_external_show` MCP tool. Mirrors the
+ * `ttctl profile external show` CLI leaf — the primary read for the
+ * stored external profile URLs (linkedin / github / website / twitter /
+ * behance / dribbble) plus `id` and the last talent-side edit timestamp.
+ *
+ * This is the read counterpart of `ttctl_profile_external_update`. Agents
+ * should use this instead of a no-op update to inspect current URL state
+ * (a no-op update is a write-disguised-as-read and risks an unintended
+ * write). Closes the read-side asymmetry documented in issue #343.
+ */
+export declare function registerProfileExternalShowTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_external_show.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile_external_show.d.ts","sourceRoot":"","sources":["../../src/tools/profile_external_show.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,EAOL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAWtB;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA6CrG"}

package/dist/tools/profile_external_show.js

@@ -0,0 +1,59 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../errors.js";
+import { buildMcpDryRunPreview, domainErrorResponse, dryRunResponse, genericErrorResponse, isToolErrorResponse, jsonResponse, } from "./_shared.js";
+const TOOL_NAME = "ttctl_profile_external_show";
+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 `ttctl_profile_external_show` MCP tool. Mirrors the
+ * `ttctl profile external show` CLI leaf — the primary read for the
+ * stored external profile URLs (linkedin / github / website / twitter /
+ * behance / dribbble) plus `id` and the last talent-side edit timestamp.
+ *
+ * This is the read counterpart of `ttctl_profile_external_update`. Agents
+ * should use this instead of a no-op update to inspect current URL state
+ * (a no-op update is a write-disguised-as-read and risks an unintended
+ * write). Closes the read-side asymmetry documented in issue #343.
+ */
+export function registerProfileExternalShowTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Show stored external profile URLs",
+        description: [
+            "Read the talent's stored external profile URLs (linkedin, github, website, twitter, behance, dribbble) plus the last talent-side edit timestamp.",
+            "",
+            "This is the READ counterpart of ttctl_profile_external_update — use it to inspect current URL state instead of a no-op update (a no-op update is a write-disguised-as-read).",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "What are my current external profile links?"',
+            '  - "Show me my stored LinkedIn / GitHub / website URLs."',
+            '  - "What Twitter handle is on my Toptal profile?"',
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("getExternalProfiles", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const result = await profile.external.show(auth.token);
+            return jsonResponse(result);
+        }
+        catch (err) {
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            if (err instanceof profile.external.ProfileError) {
+                return domainErrorResponse(TOOL_NAME, err);
+            }
+            return genericErrorResponse(TOOL_NAME, err);
+        }
+    });
+}
+//# sourceMappingURL=profile_external_show.js.map

package/dist/tools/profile_external_show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_external_show.js","sourceRoot":"","sources":["../../src/tools/profile_external_show.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,GAEb,MAAM,cAAc,CAAC;AAEtB,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAEhD,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,GAA4B;IAC7F,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EAAE;YACX,kJAAkJ;YAClJ,EAAE;YACF,8KAA8K;YAC9K,EAAE;YACF,oDAAoD;YACpD,mDAAmD;YACnD,2DAA2D;YAC3D,oDAAoD;SACrD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;KACvC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,mBAAmB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,cAAc,CACnB,qBAAqB,CACnB,qBAAqB,EACrB,gBAAgB,EAChB,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAC3D,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC;YAClD,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACjC,IAAI,GAAG,YAAY,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;gBACjD,OAAO,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,oBAAoB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/profile_external_update.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_profile_external_update` MCP tool. Mirrors the
+ * `ttctl profile external update` CLI leaf — sets one or more external
+ * profile URLs (LinkedIn, GitHub, website, Twitter, Behance, Dribbble) on
+ * the signed-in talent's profile.
+ *
+ * Each URL field is independently optional; at least one must be supplied.
+ * The schema's `--portfolio-url` from issue #76 is intentionally absent —
+ * see the service module top-comment for the spec/API reconciliation.
+ */
+export declare function registerProfileExternalUpdateTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_external_update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile_external_update.d.ts","sourceRoot":"","sources":["../../src/tools/profile_external_update.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,EAOL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAWtB;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA6DvG"}

package/dist/tools/profile_external_update.js

@@ -0,0 +1,79 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../errors.js";
+import { buildMcpDryRunPreview, domainErrorResponse, dryRunResponse, genericErrorResponse, isToolErrorResponse, jsonResponse, } from "./_shared.js";
+const TOOL_NAME = "ttctl_profile_external_update";
+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 `ttctl_profile_external_update` MCP tool. Mirrors the
+ * `ttctl profile external update` CLI leaf — sets one or more external
+ * profile URLs (LinkedIn, GitHub, website, Twitter, Behance, Dribbble) on
+ * the signed-in talent's profile.
+ *
+ * Each URL field is independently optional; at least one must be supplied.
+ * The schema's `--portfolio-url` from issue #76 is intentionally absent —
+ * see the service module top-comment for the spec/API reconciliation.
+ */
+export function registerProfileExternalUpdateTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Update external profile URLs",
+        description: [
+            "Set one or more external profile URLs (LinkedIn, GitHub, website, Twitter, Behance, Dribbble) on the signed-in talent's profile. At least one field must be provided.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Update my LinkedIn URL to https://linkedin.com/in/janedoe."',
+            '  - "Set my GitHub and personal website."',
+            '  - "Add my Behance and Dribbble profiles to my Toptal page."',
+        ].join("\n"),
+        inputSchema: {
+            linkedin: z.url().optional().describe("LinkedIn profile URL"),
+            github: z.url().optional().describe("GitHub profile URL"),
+            website: z.url().optional().describe("Personal website URL"),
+            twitter: z.url().optional().describe("Twitter / X profile URL"),
+            behance: z.url().optional().describe("Behance profile URL"),
+            dribbble: z.url().optional().describe("Dribbble profile URL"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        const changes = {};
+        if (input.linkedin !== undefined)
+            changes.linkedin = input.linkedin;
+        if (input.github !== undefined)
+            changes.github = input.github;
+        if (input.website !== undefined)
+            changes.website = input.website;
+        if (input.twitter !== undefined)
+            changes.twitter = input.twitter;
+        if (input.behance !== undefined)
+            changes.behance = input.behance;
+        if (input.dribbble !== undefined)
+            changes.dribbble = input.dribbble;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("UpdateExternalProfiles", "talent-profile", {
+                input: { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER, externalProfiles: changes },
+            }, auth.token));
+        }
+        try {
+            const result = await profile.external.update(auth.token, changes);
+            return jsonResponse(result);
+        }
+        catch (err) {
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            if (err instanceof profile.external.ProfileError) {
+                return domainErrorResponse(TOOL_NAME, err);
+            }
+            return genericErrorResponse(TOOL_NAME, err);
+        }
+    });
+}
+//# sourceMappingURL=profile_external_update.js.map

package/dist/tools/profile_external_update.js.map

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

package/dist/tools/profile_reviews_approve_item.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_profile_reviews_approve_item` MCP tool. Mirrors the
+ * `ttctl profile reviews approve-item` CLI leaf — approves a single
+ * pending item within a section review.
+ *
+ * The issue's single-positional `<id>` shorthand is replaced by named
+ * inputs because the underlying API requires three fields (`reviewId`,
+ * `itemId`, `itemKind`) to identify an item. Run
+ * `ttctl_profile_reviews_list` first to obtain the three required values.
+ *
+ * **Destructive**: approval is final per platform semantics. No `--dry-run`
+ * gate at v0; that lands separately (see issue #52).
+ */
+export declare function registerProfileReviewsApproveItemTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_reviews_approve_item.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile_reviews_approve_item.d.ts","sourceRoot":"","sources":["../../src/tools/profile_reviews_approve_item.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,EAOL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAWtB;;;;;;;;;;;;GAYG;AACH,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA6D3G"}

package/dist/tools/profile_reviews_approve_item.js

@@ -0,0 +1,77 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../errors.js";
+import { buildMcpDryRunPreview, domainErrorResponse, dryRunResponse, genericErrorResponse, isToolErrorResponse, jsonResponse, } from "./_shared.js";
+const TOOL_NAME = "ttctl_profile_reviews_approve_item";
+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. Useful for inspecting destructive approval shape before firing. Default: false.");
+/**
+ * Register the `ttctl_profile_reviews_approve_item` MCP tool. Mirrors the
+ * `ttctl profile reviews approve-item` CLI leaf — approves a single
+ * pending item within a section review.
+ *
+ * The issue's single-positional `<id>` shorthand is replaced by named
+ * inputs because the underlying API requires three fields (`reviewId`,
+ * `itemId`, `itemKind`) to identify an item. Run
+ * `ttctl_profile_reviews_list` first to obtain the three required values.
+ *
+ * **Destructive**: approval is final per platform semantics. No `--dry-run`
+ * gate at v0; that lands separately (see issue #52).
+ */
+export function registerProfileReviewsApproveItemTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Approve a pending review item",
+        description: [
+            "Approve a single pending item within a section review. DESTRUCTIVE: approval is final per platform semantics. Run `ttctl_profile_reviews_list` first to obtain the three required IDs.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Approve the suggested change to my education section item."',
+            '  - "Accept the pending edit on my employment item."',
+            '  - "Approve item ID xyz in review abc."',
+        ].join("\n"),
+        inputSchema: {
+            reviewId: z
+                .string()
+                .min(1)
+                .describe("Section-review ID. Source: `ttctl_profile_reviews_list` row's `id` field."),
+            itemId: z
+                .string()
+                .min(1)
+                .describe("Section-review-item ID. Source: `ttctl_profile_reviews_list` row's `items[].id` field."),
+            kind: z
+                .string()
+                .min(1)
+                .describe("ItemReviewKind enum value as a string (e.g. EDUCATION, EMPLOYMENT, CERTIFICATION)."),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("ApproveItemReview", "talent-profile", { input: { reviewId: input.reviewId, itemId: input.itemId, itemKind: input.kind } }, auth.token));
+        }
+        try {
+            const result = await profile.reviews.approveItem(auth.token, {
+                reviewId: input.reviewId,
+                itemId: input.itemId,
+                itemKind: input.kind,
+            });
+            return jsonResponse(result);
+        }
+        catch (err) {
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            if (err instanceof profile.reviews.ProfileError) {
+                return domainErrorResponse(TOOL_NAME, err);
+            }
+            return genericErrorResponse(TOOL_NAME, err);
+        }
+    });
+}
+//# sourceMappingURL=profile_reviews_approve_item.js.map

package/dist/tools/profile_reviews_approve_item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_reviews_approve_item.js","sourceRoot":"","sources":["../../src/tools/profile_reviews_approve_item.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,GAEb,MAAM,cAAc,CAAC;AAEtB,MAAM,SAAS,GAAG,oCAAoC,CAAC;AAEvD,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+NAA+N,CAChO,CAAC;AAEJ;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qCAAqC,CAAC,MAAiB,EAAE,GAA4B;IACnG,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE;YACX,wLAAwL;YACxL,EAAE;YACF,oDAAoD;YACpD,kEAAkE;YAClE,sDAAsD;YACtD,0CAA0C;SAC3C,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,2EAA2E,CAAC;YACxF,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,wFAAwF,CAAC;YACrG,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,oFAAoF,CAAC;YACjG,MAAM,EAAE,aAAa;SACtB;KACF,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,mBAAmB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,cAAc,CACnB,qBAAqB,CACnB,mBAAmB,EACnB,gBAAgB,EAChB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EACnF,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE;gBAC3D,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,QAAQ,EAAE,KAAK,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC;YAClD,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACjC,IAAI,GAAG,YAAY,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAChD,OAAO,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,oBAAoB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/profile_reviews_approve_section.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_profile_reviews_approve_section` MCP tool. Mirrors
+ * the `ttctl profile reviews approve-section` CLI leaf — approves all
+ * pending items within a section review.
+ *
+ * The issue's single-positional `<id>` shorthand is replaced by named
+ * inputs because the API requires both `reviewId` and `section`. Run
+ * `ttctl_profile_reviews_list` first to obtain the IDs.
+ *
+ * **Destructive**: approval is final per platform semantics.
+ */
+export declare function registerProfileReviewsApproveSectionTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_reviews_approve_section.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile_reviews_approve_section.d.ts","sourceRoot":"","sources":["../../src/tools/profile_reviews_approve_section.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,EAOL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAWtB;;;;;;;;;;GAUG;AACH,wBAAgB,wCAAwC,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAwD9G"}

package/dist/tools/profile_reviews_approve_section.js

@@ -0,0 +1,70 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../errors.js";
+import { buildMcpDryRunPreview, domainErrorResponse, dryRunResponse, genericErrorResponse, isToolErrorResponse, jsonResponse, } from "./_shared.js";
+const TOOL_NAME = "ttctl_profile_reviews_approve_section";
+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. Useful for inspecting destructive approval shape before firing. Default: false.");
+/**
+ * Register the `ttctl_profile_reviews_approve_section` MCP tool. Mirrors
+ * the `ttctl profile reviews approve-section` CLI leaf — approves all
+ * pending items within a section review.
+ *
+ * The issue's single-positional `<id>` shorthand is replaced by named
+ * inputs because the API requires both `reviewId` and `section`. Run
+ * `ttctl_profile_reviews_list` first to obtain the IDs.
+ *
+ * **Destructive**: approval is final per platform semantics.
+ */
+export function registerProfileReviewsApproveSectionTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Approve all pending items in a section",
+        description: [
+            "Approve all pending items within a section review. DESTRUCTIVE: approval is final per platform semantics. Run `ttctl_profile_reviews_list` first to obtain the section ID.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Approve all the suggested changes to my skills section."',
+            '  - "Accept all pending edits in my employment section."',
+            '  - "Approve everything in section EDUCATION."',
+        ].join("\n"),
+        inputSchema: {
+            reviewId: z
+                .string()
+                .min(1)
+                .describe("Section-review ID. Source: `ttctl_profile_reviews_list` row's `id` field."),
+            section: z
+                .string()
+                .min(1)
+                .describe("ReviewSection enum value as a string (e.g. EDUCATION, EMPLOYMENT, SKILLS)."),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("ApproveSectionReview", "talent-profile", { input: { reviewId: input.reviewId, section: input.section } }, auth.token));
+        }
+        try {
+            const result = await profile.reviews.approveSection(auth.token, {
+                reviewId: input.reviewId,
+                section: input.section,
+            });
+            return jsonResponse(result);
+        }
+        catch (err) {
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            if (err instanceof profile.reviews.ProfileError) {
+                return domainErrorResponse(TOOL_NAME, err);
+            }
+            return genericErrorResponse(TOOL_NAME, err);
+        }
+    });
+}
+//# sourceMappingURL=profile_reviews_approve_section.js.map

package/dist/tools/profile_reviews_approve_section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_reviews_approve_section.js","sourceRoot":"","sources":["../../src/tools/profile_reviews_approve_section.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,GAEb,MAAM,cAAc,CAAC;AAEtB,MAAM,SAAS,GAAG,uCAAuC,CAAC;AAE1D,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+NAA+N,CAChO,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wCAAwC,CAAC,MAAiB,EAAE,GAA4B;IACtG,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,wCAAwC;QAC/C,WAAW,EAAE;YACX,4KAA4K;YAC5K,EAAE;YACF,oDAAoD;YACpD,+DAA+D;YAC/D,0DAA0D;YAC1D,gDAAgD;SACjD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,2EAA2E,CAAC;YACxF,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,4EAA4E,CAAC;YACzF,MAAM,EAAE,aAAa;SACtB;KACF,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,mBAAmB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,cAAc,CACnB,qBAAqB,CACnB,sBAAsB,EACtB,gBAAgB,EAChB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAC/D,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE;gBAC9D,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC;YAClD,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACjC,IAAI,GAAG,YAAY,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAChD,OAAO,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,oBAAoB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/profile_reviews_list.d.ts

@@ -0,0 +1,16 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_profile_reviews_list` MCP tool. Mirrors the
+ * `ttctl profile reviews list` CLI leaf — lists pending section reviews
+ * for the signed-in talent.
+ *
+ * Each row carries the section-review ID (passed to
+ * `ttctl_profile_reviews_approve_section`) plus an `items` array; each
+ * item carries its own ID (passed to
+ * `ttctl_profile_reviews_approve_item`) and the underlying entity ID.
+ * Use this tool first before invoking the approval tools to obtain the
+ * required IDs.
+ */
+export declare function registerProfileReviewsListTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_reviews_list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile_reviews_list.d.ts","sourceRoot":"","sources":["../../src/tools/profile_reviews_list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,EAOL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAWtB;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA2CpG"}

package/dist/tools/profile_reviews_list.js

@@ -0,0 +1,58 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../errors.js";
+import { buildMcpDryRunPreview, domainErrorResponse, dryRunResponse, genericErrorResponse, isToolErrorResponse, jsonResponse, } from "./_shared.js";
+const TOOL_NAME = "ttctl_profile_reviews_list";
+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 `ttctl_profile_reviews_list` MCP tool. Mirrors the
+ * `ttctl profile reviews list` CLI leaf — lists pending section reviews
+ * for the signed-in talent.
+ *
+ * Each row carries the section-review ID (passed to
+ * `ttctl_profile_reviews_approve_section`) plus an `items` array; each
+ * item carries its own ID (passed to
+ * `ttctl_profile_reviews_approve_item`) and the underlying entity ID.
+ * Use this tool first before invoking the approval tools to obtain the
+ * required IDs.
+ */
+export function registerProfileReviewsListTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "List pending section reviews",
+        description: [
+            "List pending section reviews for the signed-in talent. Each row carries the section-review ID, section name, requestedAt timestamp, and an `items` array (each with its own id, itemId, requestedAt). Returns an empty array when no reviews are pending.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "What\'s pending review on my profile?"',
+            '  - "Show me my section reviews."',
+            '  - "Are there any unapproved changes on my profile?"',
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("sectionReviews", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const result = await profile.reviews.list(auth.token);
+            return jsonResponse(result);
+        }
+        catch (err) {
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            if (err instanceof profile.reviews.ProfileError) {
+                return domainErrorResponse(TOOL_NAME, err);
+            }
+            return genericErrorResponse(TOOL_NAME, err);
+        }
+    });
+}
+//# sourceMappingURL=profile_reviews_list.js.map

package/dist/tools/profile_reviews_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_reviews_list.js","sourceRoot":"","sources":["../../src/tools/profile_reviews_list.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,GAEb,MAAM,cAAc,CAAC;AAEtB,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAiB,EAAE,GAA4B;IAC5F,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE;YACX,2PAA2P;YAC3P,EAAE;YACF,oDAAoD;YACpD,6CAA6C;YAC7C,mCAAmC;YACnC,uDAAuD;SACxD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;KACvC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,mBAAmB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,cAAc,CACnB,qBAAqB,CACnB,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAC3D,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC;YAClD,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACjC,IAAI,GAAG,YAAY,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAChD,OAAO,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,oBAAoB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/profile_reviews_submit_for_review.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_profile_reviews_submit_for_review` MCP tool.
+ * Mirrors the `ttctl profile reviews submit-for-review` CLI leaf — re-
+ * submits the talent's profile for platform-side re-review.
+ *
+ * The platform may reject if the profile is not yet ready (cross-check
+ * via `ttctl_profile_external_readiness`). The mutation's input shape is
+ * **INFERRED — UNVERIFIED** (`{ profileId: ID! }`); deviations would
+ * surface as `USER_ERROR` at runtime.
+ */
+export declare function registerProfileReviewsSubmitForReviewTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_reviews_submit_for_review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile_reviews_submit_for_review.d.ts","sourceRoot":"","sources":["../../src/tools/profile_reviews_submit_for_review.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,EAOL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAWtB;;;;;;;;;GASG;AACH,wBAAgB,yCAAyC,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA2C/G"}

package/dist/tools/profile_reviews_submit_for_review.js

@@ -0,0 +1,56 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../errors.js";
+import { buildMcpDryRunPreview, domainErrorResponse, dryRunResponse, genericErrorResponse, isToolErrorResponse, jsonResponse, } from "./_shared.js";
+const TOOL_NAME = "ttctl_profile_reviews_submit_for_review";
+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 `ttctl_profile_reviews_submit_for_review` MCP tool.
+ * Mirrors the `ttctl profile reviews submit-for-review` CLI leaf — re-
+ * submits the talent's profile for platform-side re-review.
+ *
+ * The platform may reject if the profile is not yet ready (cross-check
+ * via `ttctl_profile_external_readiness`). The mutation's input shape is
+ * **INFERRED — UNVERIFIED** (`{ profileId: ID! }`); deviations would
+ * surface as `USER_ERROR` at runtime.
+ */
+export function registerProfileReviewsSubmitForReviewTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Submit profile for platform re-review",
+        description: [
+            "Submit the talent's profile for platform-side re-review. Used after profile edits that need re-verification (skills, employments, etc.). The platform may reject if the profile is not yet ready (use `ttctl_profile_external_readiness` to check first).",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Submit my profile for review."',
+            '  - "Re-submit my Toptal profile after my edits."',
+            '  - "I\'m done editing — submit for re-review."',
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("submitForReview", "talent-profile", { input: { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER } }, auth.token));
+        }
+        try {
+            const result = await profile.reviews.submitForReview(auth.token);
+            return jsonResponse(result);
+        }
+        catch (err) {
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            if (err instanceof profile.reviews.ProfileError) {
+                return domainErrorResponse(TOOL_NAME, err);
+            }
+            return genericErrorResponse(TOOL_NAME, err);
+        }
+    });
+}
+//# sourceMappingURL=profile_reviews_submit_for_review.js.map

package/dist/tools/profile_reviews_submit_for_review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_reviews_submit_for_review.js","sourceRoot":"","sources":["../../src/tools/profile_reviews_submit_for_review.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,GAEb,MAAM,cAAc,CAAC;AAEtB,MAAM,SAAS,GAAG,yCAAyC,CAAC;AAE5D,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ;;;;;;;;;GASG;AACH,MAAM,UAAU,yCAAyC,CAAC,MAAiB,EAAE,GAA4B;IACvG,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EAAE;YACX,2PAA2P;YAC3P,EAAE;YACF,oDAAoD;YACpD,qCAAqC;YACrC,mDAAmD;YACnD,iDAAiD;SAClD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;KACvC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,mBAAmB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,cAAc,CACnB,qBAAqB,CACnB,iBAAiB,EACjB,gBAAgB,EAChB,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,EACtE,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC;YAClD,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACjC,IAAI,GAAG,YAAY,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAChD,OAAO,mBAAmB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,oBAAoB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}