@ttctl/mcp 0.0.0 → 0.1.0-rc.2

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

package/dist/tools/profile_skills_list.d.ts

@@ -0,0 +1,16 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register `ttctl_profile_skills_list`. Returns every skill on the
+ * signed-in user's profile, with rating / experience / visibility /
+ * connection-count summary. Resolves the user's `profileId` internally
+ * via `profile.basic.show()` — no input required from the caller.
+ *
+ * Dry-run path (issue #165): accepts `dryRun?: boolean`; emits the
+ * uniform envelope previewing
+ * `getSkillSetsWithConnectionsWithConnectionsCount` against the
+ * talent-profile surface. `profileId` carries the placeholder because
+ * the apply path resolves it via a sibling profile read.
+ */
+export declare function registerProfileSkillsListTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_skills_list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile_skills_list.d.ts","sourceRoot":"","sources":["../../src/tools/profile_skills_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,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAkDnG"}

package/dist/tools/profile_skills_list.js

@@ -0,0 +1,65 @@
+// 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_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 `ttctl_profile_skills_list`. Returns every skill on the
+ * signed-in user's profile, with rating / experience / visibility /
+ * connection-count summary. Resolves the user's `profileId` internally
+ * via `profile.basic.show()` — no input required from the caller.
+ *
+ * Dry-run path (issue #165): accepts `dryRun?: boolean`; emits the
+ * uniform envelope previewing
+ * `getSkillSetsWithConnectionsWithConnectionsCount` against the
+ * talent-profile surface. `profileId` carries the placeholder because
+ * the apply path resolves it via a sibling profile read.
+ */
+export function registerProfileSkillsListTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "List profile skills",
+        description: [
+            "List every skill on the signed-in user's Toptal profile, with rating / experience / visibility / connection-count for each.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "What skills do I have on my Toptal profile?"',
+            '  - "List my Toptal skills with their ratings."',
+        ].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("getSkillSetsWithConnectionsWithConnectionsCount", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, 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 skills = await profile.skills.list(auth.token, profileId);
+            return jsonResponse(skills);
+        }
+        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_list.js.map

package/dist/tools/profile_skills_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_skills_list.js","sourceRoot":"","sources":["../../src/tools/profile_skills_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,2BAA2B,CAAC;AAE9C,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAiB,EAAE,GAA4B;IAC3F,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE;YACX,6HAA6H;YAC7H,EAAE;YACF,oDAAoD;YACpD,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,iDAAiD,EACjD,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,cAAc,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5D,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC;YAC9D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO,mBAAmB,CAAC,SAAS,EAAE;oBACpC,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,sCAAsC;iBAChD,CAAC,CAAC;YACL,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,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,IAAI,GAAG,YAAY,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAC3F,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_readiness.d.ts

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

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

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

package/dist/tools/profile_skills_readiness.js

@@ -0,0 +1,53 @@
+// 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_readiness";
+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 registerProfileSkillsReadinessTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Show skill-readiness checklist",
+        description: [
+            "Fetch the signed-in user's skill-readiness checklist — the same heuristics the portal uses to gate the 'ready to apply' state on the skills section. Each boolean reflects a sub-criterion (expert proficiency count, items count, programming language present, etc.).",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Are my Toptal skills complete enough?"',
+            '  - "Tell me what\'s missing on my skills section."',
+        ].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("getSkillsReadiness", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, 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 readiness = await profile.skills.readiness(auth.token, profileId);
+            return jsonResponse(readiness);
+        }
+        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_readiness.js.map

package/dist/tools/profile_skills_readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_skills_readiness.js","sourceRoot":"","sources":["../../src/tools/profile_skills_readiness.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,gCAAgC,CAAC;AAEnD,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ,MAAM,UAAU,kCAAkC,CAAC,MAAiB,EAAE,GAA4B;IAChG,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EAAE;YACX,yQAAyQ;YACzQ,EAAE;YACF,oDAAoD;YACpD,6CAA6C;YAC7C,qDAAqD;SACtD,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,oBAAoB,EACpB,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,cAAc,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5D,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC;YAC9D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO,mBAAmB,CAAC,SAAS,EAAE;oBACpC,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,sCAAsC;iBAChD,CAAC,CAAC;YACL,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YACxE,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC;QACjC,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,IAAI,GAAG,YAAY,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAC3F,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_remove.d.ts

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

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

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

package/dist/tools/profile_skills_remove.js

@@ -0,0 +1,53 @@
+// 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, textResponse, } from "./_shared.js";
+const TOOL_NAME = "ttctl_profile_skills_remove";
+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 registerProfileSkillsRemoveTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Remove a skill from profile",
+        description: [
+            "Remove a skill from the signed-in user's profile by its `ProfileSkillSet` id (NOT the Skill catalog id).",
+            "Get the id from `ttctl_profile_skills_list` first if you only know the skill name.",
+            "Removal cascades to any connections (portfolio items, education, employment, certifications).",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Remove the TypeScript skill from my profile." (after looking up its id)',
+            '  - "Drop skill ss-abc123 from my profile."',
+        ].join("\n"),
+        inputSchema: {
+            id: z
+                .string()
+                .min(1)
+                .describe("ProfileSkillSet id to remove (NOT the Skill catalog id). Obtain via `ttctl_profile_skills_list`."),
+            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("REMOVE_PROFILE_SKILL_SET", "talent-profile", { input: { skillSetId: input.id } }, auth.token));
+        }
+        try {
+            await profile.skills.rm(auth.token, input.id);
+            return textResponse(`Removed skill ${input.id}.`);
+        }
+        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_remove.js.map

package/dist/tools/profile_skills_remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_skills_remove.js","sourceRoot":"","sources":["../../src/tools/profile_skills_remove.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,EAEnB,YAAY,GACb,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,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,GAA4B;IAC7F,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE;YACX,0GAA0G;YAC1G,oFAAoF;YACpF,+FAA+F;YAC/F,EAAE;YACF,oDAAoD;YACpD,8EAA8E;YAC9E,6CAA6C;SAC9C,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE;YACX,EAAE,EAAE,CAAC;iBACF,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,kGAAkG,CAAC;YAC/G,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,0BAA0B,EAC1B,gBAAgB,EAChB,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EACnC,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9C,OAAO,YAAY,CAAC,iBAAiB,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;QACpD,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_show.d.ts

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

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

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

package/dist/tools/profile_skills_show.js

@@ -0,0 +1,51 @@
+// 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_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.");
+export function registerProfileSkillsShowTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Show a skill",
+        description: [
+            "Fetch details of a single ProfileSkillSet by id — name, rating, experience, visibility, and the count of connection edges (linked portfolio items / employment / education / certifications).",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Show me the details of my TypeScript skill on Toptal." (after looking up its id)',
+            '  - "What\'s the rating and connection count for skill ss-abc123?"',
+        ].join("\n"),
+        inputSchema: {
+            id: z
+                .string()
+                .min(1)
+                .describe("ProfileSkillSet id (NOT the Skill catalog id). Obtain via `ttctl_profile_skills_list`."),
+            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("GetSkillSetWithConnections", "talent-profile", { id: input.id }, auth.token));
+        }
+        try {
+            const payload = await profile.skills.show(auth.token, input.id);
+            return jsonResponse(payload);
+        }
+        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_show.js.map

package/dist/tools/profile_skills_show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_skills_show.js","sourceRoot":"","sources":["../../src/tools/profile_skills_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,2BAA2B,CAAC;AAE9C,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ,MAAM,UAAU,6BAA6B,CAAC,MAAiB,EAAE,GAA4B;IAC3F,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE;YACX,+LAA+L;YAC/L,EAAE;YACF,oDAAoD;YACpD,uFAAuF;YACvF,oEAAoE;SACrE,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE;YACX,EAAE,EAAE,CAAC;iBACF,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,wFAAwF,CAAC;YACrG,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,CAAC,4BAA4B,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CACpG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAChE,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;QAC/B,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_update.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Multi-mutation tool: `profile.skills.set` fires one mutation per
+ * supplied field (rating, experience, publicity). Dry-run therefore emits
+ * the plural `{ previews: [...] }` envelope (via {@link dryRunMultiResponse}),
+ * one preview per mutation that would actually fire — order matches the
+ * apply path's field iteration: rating → experience → public.
+ */
+export declare function registerProfileSkillsUpdateTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_skills_update.d.ts.map

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

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

package/dist/tools/profile_skills_update.js

@@ -0,0 +1,97 @@
+// 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, dryRunMultiResponse, genericErrorResponse, isToolErrorResponse, jsonResponse, } from "./_shared.js";
+const TOOL_NAME = "ttctl_profile_skills_update";
+const RATING_VALUES = ["COMPETENT", "STRONG", "EXPERT", "NOVICE"];
+const DRY_RUN_FIELD = z
+    .boolean()
+    .optional()
+    .describe("Preview the requests without executing. Returns `{ ok: true, dryRun: true, previews: [...] }` (NOTE: plural `previews` — this tool fires one mutation per supplied field, so the envelope carries an array). Default: false.");
+/**
+ * Multi-mutation tool: `profile.skills.set` fires one mutation per
+ * supplied field (rating, experience, publicity). Dry-run therefore emits
+ * the plural `{ previews: [...] }` envelope (via {@link dryRunMultiResponse}),
+ * one preview per mutation that would actually fire — order matches the
+ * apply path's field iteration: rating → experience → public.
+ */
+export function registerProfileSkillsUpdateTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Update a skill",
+        description: [
+            "Update one or more fields on an existing ProfileSkillSet — proficiency rating, years of experience, public/private visibility.",
+            "At least one of `rating`, `experience`, or `public` must be supplied. Multi-flag updates fire sequential mutations; partial-failure surfaces as `PARTIAL_FAILURE` listing which fields landed.",
+            "",
+            "Dry-run note: returns `{ ok: true, dryRun: true, previews: [...] }` (plural `previews`) — one preview per mutation that would actually fire, in apply-path order (rating → experience → public).",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Mark TypeScript as expert level on my profile." (after looking up its id)',
+            '  - "Set my Python skill to public, expert level, 60 months of experience."',
+            '  - "Hide my Bash skill from my public profile."',
+        ].join("\n"),
+        inputSchema: {
+            id: z.string().min(1).describe("ProfileSkillSet id of the skill to update (NOT the Skill catalog id)."),
+            rating: z
+                .enum(RATING_VALUES)
+                .optional()
+                .describe("Proficiency rating. One of: COMPETENT, STRONG, EXPERT, NOVICE. Optional."),
+            experience: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("Total months of experience on this skill (integer, >= 0). E.g., 60 for 5 years. Optional."),
+            public: z
+                .boolean()
+                .optional()
+                .describe("Whether the skill is visible on the public profile. `true` = public, `false` = private. Optional."),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        const fields = {};
+        if (input.rating !== undefined)
+            fields.rating = input.rating;
+        if (input.experience !== undefined)
+            fields.experience = input.experience;
+        if (input.public !== undefined)
+            fields.public = input.public;
+        if (input.dryRun === true) {
+            if (Object.keys(fields).length === 0) {
+                return domainErrorResponse(TOOL_NAME, {
+                    code: "VALIDATION_ERROR",
+                    message: "At least one of `rating`, `experience`, or `public` must be supplied to preview a skills update.",
+                });
+            }
+            const previews = [];
+            if (fields.rating !== undefined) {
+                previews.push(buildMcpDryRunPreview("UPDATE_PROFILE_SKILL_SET_RATING", "talent-profile", { input: { skillSetId: input.id, skillSet: { rating: fields.rating } } }, auth.token));
+            }
+            if (fields.experience !== undefined) {
+                previews.push(buildMcpDryRunPreview("UPDATE_PROFILE_SKILL_SET_EXPERIENCE", "talent-profile", { input: { skillSetId: input.id, skillSet: { experience: fields.experience } } }, auth.token));
+            }
+            if (fields.public !== undefined) {
+                previews.push(buildMcpDryRunPreview("UPDATE_PROFILE_SKILL_SET_PUBLICITY", "talent-profile", { input: { skillSetId: input.id, skillSet: { public: fields.public } } }, auth.token));
+            }
+            return dryRunMultiResponse(previews);
+        }
+        try {
+            const result = await profile.skills.set(auth.token, input.id, fields);
+            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_update.js.map

package/dist/tools/profile_skills_update.js.map

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

package/dist/tools/timesheet.d.ts

@@ -0,0 +1,29 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_timesheet_*` MCP tools per the #13 spec. Tool
+ * names use the `ttctl_` prefix and the canonical CLI path joined
+ * with `_`:
+ *
+ *   - `ttctl_timesheet_list`
+ *   - `ttctl_timesheet_show`
+ *   - `ttctl_timesheet_submit`
+ *
+ * Each tool maps 1:1 to a CLI leaf — schemas describe the same set of
+ * fields. Identity model:
+ *
+ *   - `BillingCycle.id`     — the "timesheet id" returned by
+ *                              `timesheet_list` and consumed by
+ *                              `timesheet_show` / `timesheet_submit`.
+ *   - `JobActivityItem.id`  — the "engagement id" exposed by
+ *                              `engagements_list`. Passed via
+ *                              `engagement` to scope.
+ *
+ * Submit is destructive — its tool description explicitly warns
+ * humans, and per #13 the CLI gates on `--confirm` / TTY interactive
+ * confirm. The MCP side has no analogous gate (LLM clients are
+ * expected to confirm with the human before invoking write tools)
+ * but the description and rationale are surfaced verbatim.
+ */
+export declare function registerTimesheetTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=timesheet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timesheet.d.ts","sourceRoot":"","sources":["../../src/tools/timesheet.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAmBnG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA0L5F"}