@ttctl/mcp 0.0.0 → 0.1.0-rc.2

package/dist/tools/profile_basic_show.js

@@ -0,0 +1,108 @@
+// 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_basic_show";
+/**
+ * Register the `ttctl_profile_basic_show` MCP tool. Mirrors the
+ * `ttctl profile basic show` CLI leaf — fetches the signed-in user's
+ * profile from both the mobile-gateway and the talent-profile surfaces
+ * and returns the merged payload.
+ *
+ * Two-call read surface (parity with CLI's post-#129 path, closed in
+ * this PR for MCP per #340):
+ *
+ *   1. `profile.basic.show()` → `mobile-gateway` for identity, role,
+ *      vertical, skills, hours, rate.
+ *   2. `profile.basic.getBasicInfo()` → `talent_profile/graphql` for
+ *      `bio` (`Profile.about`), `headline` (`Profile.quote`), and
+ *      `languages`.
+ *
+ * Errors from the secondary `getBasicInfo()` call are non-fatal: the
+ * tool swallows non-session failures and renders `basicInfo: null`, so a
+ * glitch on the secondary surface doesn't blank the whole show. Session-
+ * level errors (`AuthRevokedError`, `Cf403Error`) still propagate — they
+ * indicate the bearer is no longer valid; the primary `show()` would
+ * have hit them too.
+ *
+ * Auth token identifies the user. MCP is the LLM-facing surface, so the
+ * description includes example user-intent phrases the model can match
+ * against, and reflects the bio/headline/languages coverage added in
+ * this PR.
+ *
+ * Dry-run path (issue #165): when `dryRun: true`, the tool returns a
+ * structured preview of the primary `ProfileShow` query — no transport
+ * call. The preview shows only the mobile-gateway operation; the
+ * secondary `GET_BASIC_INFO` call on the talent-profile surface is also
+ * dispatched on the apply path but is not part of the preview envelope
+ * (single-op envelope is the cross-cutting dry-run contract; the
+ * secondary read is an implementation detail of the merged response).
+ */
+export function registerProfileBasicShowTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Show profile basic info",
+        description: [
+            "Fetch the signed-in user's Toptal Talent profile (identity, role, vertical, skills, hours, rate, bio, headline, languages).",
+            "",
+            "Returns the merged read payload from both the mobile-gateway (`profile`) and the talent-profile (`basicInfo`) surfaces. `basicInfo.bio` mirrors `Profile.about`; `basicInfo.headline` mirrors `Profile.quote`. `basicInfo` is `null` when the secondary read call fails non-fatally.",
+            "",
+            "Pass `dryRun: true` to preview the primary request without firing the query.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "What\'s on my Toptal profile?"',
+            '  - "Show me my Toptal Talent details."',
+            '  - "What\'s my hourly rate and vertical?"',
+            '  - "Show my bio and headline."',
+            '  - "What languages do I have set?"',
+        ].join("\n"),
+        inputSchema: {
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe("Preview the request without executing. Returns `{ ok: true, dryRun: true, preview: DryRunPreview }` with operationName + variables + redacted bearer header for the primary ProfileShow query. Default: false."),
+        },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("ProfileShow", "mobile-gateway", {}, auth.token));
+        }
+        let profilePayload;
+        try {
+            profilePayload = await profile.basic.show(auth.token);
+        }
+        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);
+        }
+        let basicInfo;
+        try {
+            basicInfo = await profile.basic.getBasicInfo(auth.token);
+        }
+        catch (err) {
+            // Session-level errors (AuthRevokedError, Cf403Error) propagate —
+            // the user's bearer is no longer valid and they need to act on it.
+            // The primary `show()` call would have hit the same issue, so the
+            // user must be told. Anything else (NETWORK_ERROR, GRAPHQL_ERROR
+            // on the talent-profile surface) is non-fatal: the primary payload
+            // landed, so the tool returns the partial result with
+            // `basicInfo: null`. Mirrors the CLI's post-#129 read-handler
+            // policy in `packages/cli/src/commands/profile/basic/show.ts`.
+            const typed = ttctlErrorToToolResponseOrNull(err);
+            if (typed !== null)
+                return typed;
+            basicInfo = null;
+        }
+        const payload = { profile: profilePayload, basicInfo };
+        return jsonResponse(payload);
+    });
+}
+//# sourceMappingURL=profile_basic_show.js.map

package/dist/tools/profile_basic_show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_basic_show.js","sourceRoot":"","sources":["../../src/tools/profile_basic_show.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,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;AA0B7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,GAA4B;IAC1F,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE;YACX,6HAA6H;YAC7H,EAAE;YACF,sRAAsR;YACtR,EAAE;YACF,8EAA8E;YAC9E,EAAE;YACF,oDAAoD;YACpD,qCAAqC;YACrC,yCAAyC;YACzC,4CAA4C;YAC5C,iCAAiC;YACjC,qCAAqC;SACtC,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,gNAAgN,CACjN;SACJ;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,CAAC,qBAAqB,CAAC,aAAa,EAAE,gBAAgB,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAChG,CAAC;QAED,IAAI,cAAgC,CAAC;QACrC,IAAI,CAAC;YACH,cAAc,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxD,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;QAED,IAAI,SAAyC,CAAC;QAC9C,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,kEAAkE;YAClE,mEAAmE;YACnE,kEAAkE;YAClE,iEAAiE;YACjE,mEAAmE;YACnE,sDAAsD;YACtD,8DAA8D;YAC9D,+DAA+D;YAC/D,MAAM,KAAK,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC;YAClD,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACjC,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAqB,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;QACzE,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CACF,CAAC;AACJ,CAAC"}

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