@ttctl/mcp 0.0.0 → 0.1.0-rc.1

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"}

package/dist/tools/profile_skills_add.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+export declare function registerProfileSkillsAddTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_skills_add.d.ts.map

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

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

package/dist/tools/profile_skills_add.js

@@ -0,0 +1,52 @@
+// 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_skills_add";
+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.");
+export function registerProfileSkillsAddTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Add a skill to profile",
+        description: [
+            "Add a skill to the signed-in user's profile by its catalog name (e.g., `TypeScript`, `PostgreSQL`).",
+            "Returns the new ProfileSkillSet with default rating/experience/visibility — configure those via `ttctl_profile_skills_update`.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Add TypeScript to my Toptal skills."',
+            '  - "Add PostgreSQL as a skill on my profile."',
+        ].join("\n"),
+        inputSchema: {
+            name: z
+                .string()
+                .min(1)
+                .describe('Skill catalog name to add. The server resolves the name to a Skill id; if the name is ambiguous (e.g., "Postgres" vs "PostgreSQL"), use `ttctl_profile_skills_autocomplete` first to disambiguate.'),
+            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("ADD_PROFILE_SKILL_SET", "talent-profile", { input: { name: input.name.trim() } }, auth.token));
+        }
+        try {
+            const result = await profile.skills.add(auth.token, input.name);
+            return jsonResponse(result);
+        }
+        catch (err) {
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            if (err instanceof profile.skills.SkillsError) {
+                return domainErrorResponse(TOOL_NAME, err);
+            }
+            return genericErrorResponse(TOOL_NAME, err);
+        }
+    });
+}
+//# sourceMappingURL=profile_skills_add.js.map

package/dist/tools/profile_skills_add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_skills_add.js","sourceRoot":"","sources":["../../src/tools/profile_skills_add.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,0BAA0B,CAAC;AAE7C,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,GAA4B;IAC1F,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE;YACX,qGAAqG;YACrG,gIAAgI;YAChI,EAAE;YACF,oDAAoD;YACpD,2CAA2C;YAC3C,gDAAgD;SACjD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE;YACX,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,oMAAoM,CACrM;YACH,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,uBAAuB,EACvB,gBAAgB,EAChB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EACtC,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAChE,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,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC9C,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_skills_autocomplete.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+export declare function registerProfileSkillsAutocompleteTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_skills_autocomplete.d.ts.map

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

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

package/dist/tools/profile_skills_autocomplete.js

@@ -0,0 +1,78 @@
+// 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_skills_autocomplete";
+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.");
+export function registerProfileSkillsAutocompleteTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Search global skill catalog",
+        description: [
+            "Search the global Toptal skill catalog for entries matching `query` (suitable for disambiguating before calling `ttctl_profile_skills_add`).",
+            "Results are scoped to skills the talent's vertical permits and exclude any ids passed in `withoutIds` (e.g., the talent's existing skills).",
+            "",
+            "Example user prompts that should map to this tool:",
+            "  - \"Search Toptal's catalog for 'postgres' before I add it.\"",
+            "  - \"Find skill names matching 'java'.\"",
+        ].join("\n"),
+        inputSchema: {
+            query: z.string().min(1).describe("Substring to search for in skill names. Case-insensitive."),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe("Max number of suggestions to return. Defaults to 10. Range: 1-50."),
+            withoutIds: z
+                .array(z.string().min(1))
+                .optional()
+                .describe("Skill catalog ids to exclude from the results — typically the talent's existing skill catalog ids so the dropdown doesn't suggest skills already on the profile."),
+            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("GET_SKILLS_FOR_AUTOCOMPLETE", "talent-profile", {
+                profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER,
+                search: input.query.trim(),
+                limit: input.limit ?? 10,
+                withoutIds: input.withoutIds ?? [],
+            }, auth.token));
+        }
+        try {
+            const profilePayload = await profile.basic.show(auth.token);
+            const profileId = profilePayload.viewer?.viewerRole.profileId;
+            if (profileId === undefined) {
+                return domainErrorResponse(TOOL_NAME, {
+                    code: "NO_VIEWER",
+                    message: "No profile id bound to this session.",
+                });
+            }
+            const options = {};
+            if (input.limit !== undefined)
+                options.limit = input.limit;
+            if (input.withoutIds !== undefined)
+                options.withoutIds = input.withoutIds;
+            const suggestions = await profile.skills.autocomplete(auth.token, profileId, input.query, options);
+            return jsonResponse(suggestions);
+        }
+        catch (err) {
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            if (err instanceof profile.skills.SkillsError || err instanceof profile.basic.ProfileError) {
+                return domainErrorResponse(TOOL_NAME, err);
+            }
+            return genericErrorResponse(TOOL_NAME, err);
+        }
+    });
+}
+//# sourceMappingURL=profile_skills_autocomplete.js.map

package/dist/tools/profile_skills_autocomplete.js.map

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