@ttctl/mcp 0.0.0 → 0.1.0-rc.1

package/dist/tools/profile_basic_update.d.ts

@@ -0,0 +1,37 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_profile_basic_update` MCP tool. Mirrors the
+ * `ttctl profile basic update --bio --headline` CLI leaf — updates the
+ * signed-in user's bio and/or headline via the talent-profile surface.
+ *
+ * Free-text input modes (stdin / `@file` / `--edit`) are CLI-specific
+ * affordances and DO NOT apply here: MCP callers pass the resolved
+ * string verbatim. The `bio` and `headline` parameters are both
+ * optional; at least one must be supplied (the core layer validates
+ * this and raises a `VALIDATION_ERROR` if both are omitted).
+ *
+ * Dry-run path (issue #10, harmonised under #165): when `dryRun: true`
+ * is supplied, the tool routes through
+ * `profile.basic.set(token, changes, { dryRun: true })` which returns a
+ * `SetOutcomePreview`. The MCP layer projects that to the uniform
+ * `{ ok: true, dryRun: true, preview }` envelope shared by every #165
+ * dry-run path. The apply path returns the `UpdateProfileResult`
+ * payload directly (the prior `{ kind: "applied", result }` wrapper is
+ * dropped — see "Breaking change" note below).
+ *
+ * **Breaking change vs #10's original wire format (pre-1.0, acceptable):**
+ *
+ *   - Old apply: `{ kind: "applied", result: { profile, notice } }`
+ *   - New apply: `{ profile, notice }`
+ *   - Old dry-run: `{ kind: "preview", preview: { ... } }`
+ *   - New dry-run: `{ ok: true, dryRun: true, preview: { ... } }`
+ *
+ * The new envelopes match the rest of the MCP surface — every tool's
+ * dry-run path emits `{ ok: true, dryRun: true, preview }` uniformly
+ * (issue #165), and apply paths emit the domain payload directly.
+ * Bearer token redaction in `headers.authorization` is honored by
+ * `buildDryRunPreview` in core; the MCP tool is a thin pass-through.
+ */
+export declare function registerProfileBasicUpdateTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_basic_update.d.ts.map

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

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

package/dist/tools/profile_basic_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 { domainErrorResponse, dryRunResponse, genericErrorResponse, isToolErrorResponse, jsonResponse, } from "./_shared.js";
+import { profileBasicUpdateOutputSchema } from "./output-schemas.js";
+const TOOL_NAME = "ttctl_profile_basic_update";
+/**
+ * Register the `ttctl_profile_basic_update` MCP tool. Mirrors the
+ * `ttctl profile basic update --bio --headline` CLI leaf — updates the
+ * signed-in user's bio and/or headline via the talent-profile surface.
+ *
+ * Free-text input modes (stdin / `@file` / `--edit`) are CLI-specific
+ * affordances and DO NOT apply here: MCP callers pass the resolved
+ * string verbatim. The `bio` and `headline` parameters are both
+ * optional; at least one must be supplied (the core layer validates
+ * this and raises a `VALIDATION_ERROR` if both are omitted).
+ *
+ * Dry-run path (issue #10, harmonised under #165): when `dryRun: true`
+ * is supplied, the tool routes through
+ * `profile.basic.set(token, changes, { dryRun: true })` which returns a
+ * `SetOutcomePreview`. The MCP layer projects that to the uniform
+ * `{ ok: true, dryRun: true, preview }` envelope shared by every #165
+ * dry-run path. The apply path returns the `UpdateProfileResult`
+ * payload directly (the prior `{ kind: "applied", result }` wrapper is
+ * dropped — see "Breaking change" note below).
+ *
+ * **Breaking change vs #10's original wire format (pre-1.0, acceptable):**
+ *
+ *   - Old apply: `{ kind: "applied", result: { profile, notice } }`
+ *   - New apply: `{ profile, notice }`
+ *   - Old dry-run: `{ kind: "preview", preview: { ... } }`
+ *   - New dry-run: `{ ok: true, dryRun: true, preview: { ... } }`
+ *
+ * The new envelopes match the rest of the MCP surface — every tool's
+ * dry-run path emits `{ ok: true, dryRun: true, preview }` uniformly
+ * (issue #165), and apply paths emit the domain payload directly.
+ * Bearer token redaction in `headers.authorization` is honored by
+ * `buildDryRunPreview` in core; the MCP tool is a thin pass-through.
+ */
+export function registerProfileBasicUpdateTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Update profile basic info",
+        description: [
+            "Update the signed-in user's profile bio and/or headline. At least one must be supplied.",
+            "Pass `dryRun: true` to preview the request without firing the mutation.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Update my bio to: Senior backend engineer specialising in Go and PostgreSQL."',
+            "  - \"Change my Toptal headline to 'CTO at AcmeCo'.\"",
+            '  - "Set my profile bio and headline."',
+            '  - "Show me what would be sent if I changed my bio to X."',
+        ].join("\n"),
+        inputSchema: {
+            bio: z
+                .string()
+                .optional()
+                .describe("Long-form bio paragraph (multi-line). Maps to GraphQL `Profile.about`. Optional. The empty string is a valid value (clears the bio); pass `undefined` to leave the existing bio unchanged."),
+            headline: z
+                .string()
+                .optional()
+                .describe("Short tagline shown above the user's photo (single line). Maps to GraphQL `Profile.quote`. Optional."),
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe("Preview the request without executing. Returns `{ ok: true, dryRun: true, preview: DryRunPreview }` carrying the `UPDATE_BASIC_INFO` operation + redacted bearer header. No transport (read or write) is invoked. Default: false."),
+        },
+        outputSchema: profileBasicUpdateOutputSchema.shape,
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        const changes = {};
+        if (input.bio !== undefined)
+            changes.bio = input.bio;
+        if (input.headline !== undefined)
+            changes.headline = input.headline;
+        try {
+            const outcome = await profile.basic.set(auth.token, changes, { dryRun: input.dryRun ?? false });
+            if (outcome.kind === "preview") {
+                return dryRunResponse(outcome.preview);
+            }
+            return jsonResponse(outcome.result);
+        }
+        catch (err) {
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            if (err instanceof profile.basic.ProfileError) {
+                return domainErrorResponse(TOOL_NAME, err);
+            }
+            return genericErrorResponse(TOOL_NAME, err);
+        }
+    });
+}
+//# sourceMappingURL=profile_basic_update.js.map

package/dist/tools/profile_basic_update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_basic_update.js","sourceRoot":"","sources":["../../src/tools/profile_basic_update.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,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,GAEb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAErE,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAiB,EAAE,GAA4B;IAC5F,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE;YACX,yFAAyF;YACzF,yEAAyE;YACzE,EAAE;YACF,oDAAoD;YACpD,oFAAoF;YACpF,uDAAuD;YACvD,wCAAwC;YACxC,4DAA4D;SAC7D,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,4LAA4L,CAC7L;YACH,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,sGAAsG,CACvG;YACH,MAAM,EAAE,CAAC;iBACN,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,mOAAmO,CACpO;SACJ;QACD,YAAY,EAAE,8BAA8B,CAAC,KAAK;KACnD,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,MAAM,OAAO,GAAgC,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACrD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAEpE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;YAChG,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC/B,OAAO,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,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,KAAK,CAAC,YAAY,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_external_advanced_wizard_show.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_advanced_wizard_show` MCP tool.
+ * Mirrors the `ttctl profile external advanced-wizard show` CLI leaf —
+ * reads the advanced-profile-wizard status plus a summary of the talent's
+ * travel-visa list (count + IDs).
+ *
+ * Visa CRUD lives in the `ttctl_profile_visas_*` sub-domain — surfacing
+ * the rich shape here would create a partial duplication that drifts as
+ * the visas sub-domain evolves.
+ */
+export declare function registerProfileExternalAdvancedWizardShowTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_external_advanced_wizard_show.d.ts.map

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

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

package/dist/tools/profile_external_advanced_wizard_show.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_external_advanced_wizard_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_advanced_wizard_show` MCP tool.
+ * Mirrors the `ttctl profile external advanced-wizard show` CLI leaf —
+ * reads the advanced-profile-wizard status plus a summary of the talent's
+ * travel-visa list (count + IDs).
+ *
+ * Visa CRUD lives in the `ttctl_profile_visas_*` sub-domain — surfacing
+ * the rich shape here would create a partial duplication that drifts as
+ * the visas sub-domain evolves.
+ */
+export function registerProfileExternalAdvancedWizardShowTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Show advanced-profile wizard status",
+        description: [
+            "Read the advanced-profile-wizard status plus a summary of the talent's travel-visa list (count + IDs).",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "What\'s the state of my advanced-profile wizard?"',
+            '  - "Have I finished the advanced profile setup?"',
+            '  - "Show me my travel-visa summary."',
+        ].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("getAdvancedProfileData", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const result = await profile.external.advancedWizardShow(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_advanced_wizard_show.js.map

package/dist/tools/profile_external_advanced_wizard_show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_external_advanced_wizard_show.js","sourceRoot":"","sources":["../../src/tools/profile_external_advanced_wizard_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,6CAA6C,CAAC;AAEhE,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ;;;;;;;;;GASG;AACH,MAAM,UAAU,6CAA6C,CAAC,MAAiB,EAAE,GAA4B;IAC3G,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EAAE;YACX,wGAAwG;YACxG,EAAE;YACF,oDAAoD;YACpD,wDAAwD;YACxD,mDAAmD;YACnD,uCAAuC;SACxC,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,wBAAwB,EACxB,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,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrE,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_custom_requirements_set.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_profile_external_custom_requirements_set` MCP tool.
+ * Mirrors the `ttctl profile external custom-requirements set` CLI leaf —
+ * toggles one or more of the three onboarding-readiness booleans.
+ *
+ * Caller-omitted fields default to the current server state (the
+ * underlying mutation has no PATCH semantics — the service layer fetches
+ * current state and merges before sending).
+ */
+export declare function registerProfileExternalCustomRequirementsSetTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_external_custom_requirements_set.d.ts.map

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

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

package/dist/tools/profile_external_custom_requirements_set.js

@@ -0,0 +1,75 @@
+// 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_custom_requirements_set";
+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. Note: the apply path merges with the current server state via a sibling read; the dry-run preview shows only the user-supplied diff in `customRequirements`, not the merged final shape. Default: false.");
+/**
+ * Register the `ttctl_profile_external_custom_requirements_set` MCP tool.
+ * Mirrors the `ttctl profile external custom-requirements set` CLI leaf —
+ * toggles one or more of the three onboarding-readiness booleans.
+ *
+ * Caller-omitted fields default to the current server state (the
+ * underlying mutation has no PATCH semantics — the service layer fetches
+ * current state and merges before sending).
+ */
+export function registerProfileExternalCustomRequirementsSetTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Update custom requirements",
+        description: [
+            "Toggle one or more of the three onboarding-readiness booleans (background-check, drug-test, time-tracking-tools). Caller-omitted fields default to the current server state. At least one field must be supplied.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Opt me into background-check screening."',
+            '  - "Mark me as willing to use time-tracking tools."',
+            '  - "Toggle off the drug-test flag on my profile."',
+        ].join("\n"),
+        inputSchema: {
+            backgroundCheck: z
+                .boolean()
+                .optional()
+                .describe("Willing to undergo a background check (true|false). Optional."),
+            drugTest: z.boolean().optional().describe("Willing to undergo a drug test (true|false). Optional."),
+            timeTrackingTools: z
+                .boolean()
+                .optional()
+                .describe("Willing to use time-tracking tools (true|false). Optional."),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        const changes = {};
+        if (input.backgroundCheck !== undefined)
+            changes.backgroundCheck = input.backgroundCheck;
+        if (input.drugTest !== undefined)
+            changes.drugTest = input.drugTest;
+        if (input.timeTrackingTools !== undefined)
+            changes.timeTrackingTools = input.timeTrackingTools;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("updateCustomRequirements", "talent-profile", {
+                input: { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER, customRequirements: changes },
+            }, auth.token));
+        }
+        try {
+            const result = await profile.external.customRequirementsSet(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_custom_requirements_set.js.map

package/dist/tools/profile_external_custom_requirements_set.js.map

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

package/dist/tools/profile_external_custom_requirements_show.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_custom_requirements_show` MCP tool.
+ * Mirrors the `ttctl profile external custom-requirements show` CLI leaf —
+ * reads the three onboarding-readiness toggles (background-check,
+ * drug-test, time-tracking-tools).
+ *
+ * Despite the issue's "free-text" framing, the underlying API is a
+ * boolean trio. See the service module top-comment for the spec/API
+ * reconciliation.
+ */
+export declare function registerProfileExternalCustomRequirementsShowTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_external_custom_requirements_show.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile_external_custom_requirements_show.d.ts","sourceRoot":"","sources":["../../src/tools/profile_external_custom_requirements_show.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,iDAAiD,CAC/D,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,uBAAuB,GAC3B,IAAI,CA2CN"}

package/dist/tools/profile_external_custom_requirements_show.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_external_custom_requirements_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_custom_requirements_show` MCP tool.
+ * Mirrors the `ttctl profile external custom-requirements show` CLI leaf —
+ * reads the three onboarding-readiness toggles (background-check,
+ * drug-test, time-tracking-tools).
+ *
+ * Despite the issue's "free-text" framing, the underlying API is a
+ * boolean trio. See the service module top-comment for the spec/API
+ * reconciliation.
+ */
+export function registerProfileExternalCustomRequirementsShowTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Show custom requirements",
+        description: [
+            "Read the three onboarding-readiness toggles (background-check, drug-test, time-tracking-tools) for the signed-in talent.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Am I opted into background checks?"',
+            '  - "What\'s my onboarding-readiness state?"',
+            '  - "Show my custom requirements."',
+        ].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("getCustomRequirements", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const result = await profile.external.customRequirementsShow(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_custom_requirements_show.js.map

package/dist/tools/profile_external_custom_requirements_show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_external_custom_requirements_show.js","sourceRoot":"","sources":["../../src/tools/profile_external_custom_requirements_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,iDAAiD,CAAC;AAEpE,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ;;;;;;;;;GASG;AACH,MAAM,UAAU,iDAAiD,CAC/D,MAAiB,EACjB,GAA4B;IAE5B,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE;YACX,0HAA0H;YAC1H,EAAE;YACF,oDAAoD;YACpD,0CAA0C;YAC1C,8CAA8C;YAC9C,oCAAoC;SACrC,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,uBAAuB,EACvB,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,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzE,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_readiness.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_profile_external_readiness` MCP tool. Mirrors the
+ * `ttctl profile external readiness` CLI leaf — reads the per-section
+ * profile-readiness checklist plus the rolled-up `submitAvailable` flag.
+ *
+ * Used to know which sections still need work before the talent can
+ * submit-for-review.
+ */
+export declare function registerProfileExternalReadinessTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_external_readiness.d.ts.map

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

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

package/dist/tools/profile_external_readiness.js

@@ -0,0 +1,54 @@
+// 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_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.");
+/**
+ * Register the `ttctl_profile_external_readiness` MCP tool. Mirrors the
+ * `ttctl profile external readiness` CLI leaf — reads the per-section
+ * profile-readiness checklist plus the rolled-up `submitAvailable` flag.
+ *
+ * Used to know which sections still need work before the talent can
+ * submit-for-review.
+ */
+export function registerProfileExternalReadinessTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Show profile readiness",
+        description: [
+            "Read the per-section profile-readiness checklist (photo, basic info, skills, employments, portfolio, working hours, etc.) plus the rolled-up `submitAvailable` flag.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Is my Toptal profile ready to submit?"',
+            '  - "Which sections still need work?"',
+            '  - "Show me my profile-readiness checklist."',
+        ].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("getProfileReadiness", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const result = await profile.external.readiness(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_readiness.js.map

package/dist/tools/profile_external_readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_external_readiness.js","sourceRoot":"","sources":["../../src/tools/profile_external_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,kCAAkC,CAAC;AAErD,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ;;;;;;;GAOG;AACH,MAAM,UAAU,oCAAoC,CAAC,MAAiB,EAAE,GAA4B;IAClG,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE;YACX,sKAAsK;YACtK,EAAE;YACF,oDAAoD;YACpD,6CAA6C;YAC7C,uCAAuC;YACvC,+CAA+C;SAChD,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,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5D,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_recommendations.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_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 declare function registerProfileExternalRecommendationsTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_external_recommendations.d.ts.map

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

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

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