From 7d1e57aafc8ce0be75657a90ad41412deb2a7a9a Mon Sep 17 00:00:00 2001
From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
Date: Wed, 3 Jun 2026 17:03:21 -0700
Subject: [PATCH 1/3] fix broken links

---
 .typedoc/custom-plugin.mjs                | 2 +-
 packages/shared/src/types/session.ts      | 2 +-
 packages/shared/src/types/signUpFuture.ts | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.typedoc/custom-plugin.mjs b/.typedoc/custom-plugin.mjs
index f4b65d3f5cd..de118fe4286 100644
--- a/.typedoc/custom-plugin.mjs
+++ b/.typedoc/custom-plugin.mjs
@@ -335,7 +335,7 @@ function getCatchAllReplacements() {
     },
     {
       pattern: /(?<![\[\w`#])`?UserResource`?(?![\]\w`])/g,
-      replace: '[`UserResource`](/docs/reference/objects/user)',
+      replace: '[UserResource](/docs/reference/objects/user)',
     },
     {
       pattern: /(?<![\[\w`#])`?LastAuthenticationStrategy`?(?![\]\w`])/g,
diff --git a/packages/shared/src/types/session.ts b/packages/shared/src/types/session.ts
index ce38f9f7e26..5e148977474 100644
--- a/packages/shared/src/types/session.ts
+++ b/packages/shared/src/types/session.ts
@@ -247,7 +247,7 @@ export interface SessionResource extends ClerkResource {
    */
   actor: ActClaim | null;
   /**
-   * When the session's actor claim has `type: 'agent'`, this property exposes information about the agent and [Agent Task](https://clerk.com/docs/reference/objects/agent-task) that was used to create the session.
+   * When the session's actor claim has `type: 'agent'`, this property exposes information about the agent and [Agent Task](https://clerk.com/docs/reference/types/agent-task) that was used to create the session.
    */
   agent: AgentActClaim | null;
   /**
diff --git a/packages/shared/src/types/signUpFuture.ts b/packages/shared/src/types/signUpFuture.ts
index 22629e6f5ac..27a47c5756f 100644
--- a/packages/shared/src/types/signUpFuture.ts
+++ b/packages/shared/src/types/signUpFuture.ts
@@ -203,7 +203,7 @@ export interface SignUpFuturePhoneCodeVerifyParams {
 /** @generateWithEmptyComment */
 export interface SignUpFutureSSOParams extends SignUpFutureAdditionalParams {
   /**
-   * The strategy to use for authentication. Either [`OAuthStrategy`](https://clerk.com/docs/reference/types/oauth-strategy) or [`EnterpriseSSOStrategy`](https://clerk.com/docs/reference/types/enterprise-sso-strategy).
+   * The strategy to use for authentication. Either [`OAuthStrategy`](https://clerk.com/docs/reference/types/sso#o-auth-strategy) or [`EnterpriseSSOStrategy`](https://clerk.com/docs/reference/types/sso#enterprise-sso-strategy).
    */
   strategy: string;
   /**

From a8c5f2c2d0ee643998793b9fb9ddb8fc1808fa0d Mon Sep 17 00:00:00 2001
From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
Date: Wed, 3 Jun 2026 17:11:22 -0700
Subject: [PATCH 2/3] fix(repo): broaden typedoc catch-all link patterns to
 match more contexts

Unify 12 catch-all replacement patterns in `.typedoc/custom-plugin.mjs` to
use the more-encompassing form `(?<![\[\w`#])`?Foo`?(?![\]\w`])` so they
match both backticked and bare identifiers. Newly linkifies
`ClerkAPIResponseError` (was excluded from backticked form) and
`OrganizationPublicMetadata` inside `<code>` HTML tags.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .typedoc/custom-plugin.mjs | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/.typedoc/custom-plugin.mjs b/.typedoc/custom-plugin.mjs
index de118fe4286..2dd1fa921a9 100644
--- a/.typedoc/custom-plugin.mjs
+++ b/.typedoc/custom-plugin.mjs
@@ -176,7 +176,7 @@ export function applyRelativeLinkReplacements(contents) {
 function getCatchAllReplacements() {
   return [
     {
-      pattern: /(?<![`[\]])\bClerkAPIResponseError\b(?![\]\(])/g,
+      pattern: /(?<![\[\w`#])`?ClerkAPIResponseError`?(?![\]\w`])/g,
       replace: '[ClerkAPIResponseError](/docs/reference/types/clerk-api-response-error)',
     },
     {
@@ -204,7 +204,7 @@ function getCatchAllReplacements() {
       replace: '[ExternalAccountResource](/docs/reference/types/external-account)',
     },
     {
-      pattern: /(?<![#])`LoadedClerk`/g,
+      pattern: /(?<![\[\w`#])`?LoadedClerk`?(?![\]\w`])/g,
       replace: '[Clerk](/docs/reference/objects/clerk)',
     },
     {
@@ -230,7 +230,7 @@ function getCatchAllReplacements() {
       replace: '[SessionStatusClaim](/docs/reference/types/session-status)',
     },
     {
-      pattern: /(?<![`#[\]])\bSetActiveParams\b(?![\]\(])/g,
+      pattern: /(?<![\[\w`#])`?SetActiveParams`?(?![\]\w`])/g,
       replace: '[SetActiveParams](/docs/reference/types/set-active-params)',
     },
     {
@@ -258,11 +258,11 @@ function getCatchAllReplacements() {
       replace: '[SignedInSessionResource](/docs/reference/objects/session)',
     },
     {
-      pattern: /(?<![#])`SignInRedirectOptions`/g,
+      pattern: /(?<![\[\w`#])`?SignInRedirectOptions`?(?![\]\w`])/g,
       replace: '[SignInRedirectOptions](/docs/reference/types/sign-in-redirect-options)',
     },
     {
-      pattern: /(?<![#])`SignUpRedirectOptions`/g,
+      pattern: /(?<![\[\w`#])`?SignUpRedirectOptions`?(?![\]\w`])/g,
       replace: '[SignUpRedirectOptions](/docs/reference/types/sign-up-redirect-options)',
     },
     {
@@ -274,7 +274,7 @@ function getCatchAllReplacements() {
       replace: '[SignUpVerificationResource](/docs/reference/types/sign-up-verification-resource)',
     },
     {
-      pattern: /(?<![#])`SignUpUnsafeMetadata`/g,
+      pattern: /(?<![\[\w`#])`?SignUpUnsafeMetadata`?(?![\]\w`])/g,
       replace: '[SignUpUnsafeMetadata](/docs/reference/types/metadata#sign-up-unsafe-metadata)',
     },
     {
@@ -282,7 +282,7 @@ function getCatchAllReplacements() {
       replace: '[SignUpFutureResource](/docs/reference/objects/sign-up-future)',
     },
     {
-      pattern: /(?<![#])`TasksRedirectOptions`/g,
+      pattern: /(?<![\[\w`#])`?TasksRedirectOptions`?(?![\]\w`])/g,
       replace: '[TasksRedirectOptions](/docs/reference/types/redirect-options)',
     },
     {
@@ -294,30 +294,30 @@ function getCatchAllReplacements() {
       replace: '[OrganizationResource](/docs/reference/objects/organization)',
     },
     {
-      pattern: /(?<![#])`OrganizationPrivateMetadata`/g,
+      pattern: /(?<![\[\w`#])`?OrganizationPrivateMetadata`?(?![\]\w`])/g,
       replace: '[OrganizationPrivateMetadata](/docs/reference/types/metadata#organization-private-metadata)',
     },
     {
-      pattern: /(?<![#])`OrganizationPublicMetadata`/g,
+      pattern: /(?<![\[\w`#])`?OrganizationPublicMetadata`?(?![\]\w`])/g,
       replace: '[OrganizationPublicMetadata](/docs/reference/types/metadata#organization-public-metadata)',
     },
     {
-      pattern: /(?<![#])`OrganizationInvitationPrivateMetadata`/g,
+      pattern: /(?<![\[\w`#])`?OrganizationInvitationPrivateMetadata`?(?![\]\w`])/g,
       replace:
         '[OrganizationInvitationPrivateMetadata](/docs/reference/types/metadata#organization-invitation-private-metadata)',
     },
     {
-      pattern: /(?<![#])`OrganizationInvitationPublicMetadata`/g,
+      pattern: /(?<![\[\w`#])`?OrganizationInvitationPublicMetadata`?(?![\]\w`])/g,
       replace:
         '[OrganizationInvitationPublicMetadata](/docs/reference/types/metadata#organization-invitation-public-metadata)',
     },
     {
-      pattern: /(?<![#])`OrganizationMembershipPrivateMetadata`/g,
+      pattern: /(?<![\[\w`#])`?OrganizationMembershipPrivateMetadata`?(?![\]\w`])/g,
       replace:
         '[OrganizationMembershipPrivateMetadata](/docs/reference/types/metadata#organization-membership-private-metadata)',
     },
     {
-      pattern: /(?<![#])`OrganizationMembershipPublicMetadata`/g,
+      pattern: /(?<![\[\w`#])`?OrganizationMembershipPublicMetadata`?(?![\]\w`])/g,
       replace:
         '[OrganizationMembershipPublicMetadata](/docs/reference/types/metadata#organization-membership-public-metadata)',
     },

From 4b60067b1c65e61c71cb6308a23e107d5607086a Mon Sep 17 00:00:00 2001
From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
Date: Wed, 3 Jun 2026 17:19:59 -0700
Subject: [PATCH 3/3] chore(repo): add empty changeset

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .changeset/stale-steaks-accept.md | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 .changeset/stale-steaks-accept.md

diff --git a/.changeset/stale-steaks-accept.md b/.changeset/stale-steaks-accept.md
new file mode 100644
index 00000000000..a845151cc84
--- /dev/null
+++ b/.changeset/stale-steaks-accept.md
@@ -0,0 +1,2 @@
+---
+---