shakers-cli 0.0.0-stage → 0.14.1

package/src/mcp-onboarding-tools.js

@@ -0,0 +1,379 @@
+'use strict';
+
+const path = require('path');
+const { askConsent } = require('./mcp-choice');
+const { tildify } = require('./env-paths');
+
+const LOGOUT_SCHEMA = { type: 'object', properties: {} };
+
+const LIST_ADDABLE_SCHEMA = { type: 'object', properties: {} };
+
+const ADD_SKILL_SCHEMA = {
+  type: 'object',
+  properties: {
+    skillId: { type: 'integer', description: 'The skillId to declare, from list_addable.skills[].skillId.' },
+    relatedPortfolioIds: {
+      type: 'array',
+      items: { type: 'string' },
+      description: "Optional portfolio/experience IDs to relate this skill to (from a prior response's `portfolios[].id`, or from add_project). Omit to declare without a relation — the response always returns the talent's current `portfolios` so you know the IDs for the NEXT add_skill call.",
+    },
+  },
+  required: ['skillId'],
+};
+
+const ADD_AGENT_SCHEMA = {
+  type: 'object',
+  properties: {
+    agentName: { type: 'string', description: 'The agent name to declare, from list_addable.agents[].name.' },
+    whatItDoes: { type: 'string' },
+    humanDecides: { type: 'string' },
+    relatedPortfolios: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          portfolioId: { type: 'string', description: "A portfolio/experience id (from a prior response's `portfolios[].id`, or from add_project)." },
+        },
+        required: ['portfolioId'],
+      },
+      description: "Optional experiences to relate this agent to (matches the web's 'Relate to an experience' step). Replace-set. Omit to declare without a relation — the response always returns the talent's current `portfolios` so you know the IDs for a follow-up call.",
+    },
+  },
+  required: ['agentName'],
+};
+
+const ADD_PROJECT_SCHEMA = {
+  type: 'object',
+  properties: {
+    root: { type: 'string', description: 'Repository root. Defaults to the server working directory. Its name and remote URL seed the portfolio entry.' },
+    name: { type: 'string', description: 'Portfolio entry name. Defaults to the repository directory name.' },
+    type: { type: 'string', enum: ['PORTFOLIO', 'EXPERIENCE'], description: 'Defaults to PORTFOLIO.' },
+    description: { type: 'string' },
+    url: { type: 'string', description: 'Defaults to the git remote origin URL when available.' },
+    clientName: { type: 'string', description: 'Client name (optional, e.g. for freelance work).' },
+    clientDomain: { type: 'string', description: "Client website or domain (optional, e.g. 'acme.com' or a full URL — normalized to a bare domain). Hub generates the client logo from it." },
+    skillIds: { type: 'array', items: { type: 'integer' } },
+    answer: { type: 'string', description: 'The option the talent picked when you printed the question this tool returned. Never set it yourself.' },
+  },
+};
+
+function makeOnboardingTools(deps = {}) {
+  const {
+    getLoginEndpoint = require('./config').getLoginEndpoint,
+    clearAuthSession = require('./auth-session-store').clearAuthSession,
+    getUsageDiscoveredInventoryEndpoint = require('./config').getUsageDiscoveredInventoryEndpoint,
+    getSkillsDeclareEndpoint = require('./config').getSkillsDeclareEndpoint,
+    getAgentsDeclareEndpoint = require('./config').getAgentsDeclareEndpoint,
+    getAgentsListEndpoint = require('./config').getAgentsListEndpoint,
+    getPortfoliosDeclareEndpoint = require('./config').getPortfoliosDeclareEndpoint,
+    getPortfoliosListEndpoint = require('./config').getPortfoliosListEndpoint,
+    getPortfolioUpdateEndpoint = require('./config').getPortfolioUpdateEndpoint,
+    getAgentPortfoliosEndpoint = require('./config').getAgentPortfoliosEndpoint,
+    requestLogin = require('./auth-client').requestLogin,
+    saveAuthSession = require('./auth-session-store').saveAuthSession,
+    loadAuthSession = require('./auth-session-store').loadAuthSession,
+    sessionStatus = require('./auth-session-store').sessionStatus,
+    requestDiscoveredInventory = require('./inventory-client').requestDiscoveredInventory,
+    requestDiscoveredInventoryWithRefresh = require('./inventory-client').requestDiscoveredInventoryWithRefresh,
+    ensureFreshSession = require('./session-refresh').ensureFreshSession,
+    requestDeclareSkill = require('./skills-client').requestDeclareSkill,
+    requestDeclareAgent = require('./agents-client').requestDeclareAgent,
+    requestListAgents = require('./agents-client').requestListAgents,
+    requestRelateAgentPortfolios = require('./agents-client').requestRelateAgentPortfolios,
+    requestDeclarePortfolio = require('./portfolio-client').requestDeclarePortfolio,
+    requestListPortfolios = require('./portfolio-client').requestListPortfolios,
+    requestUpdatePortfolioSkills = require('./portfolio-client').requestUpdatePortfolioSkills,
+    getRemoteUrl = require('./portfolio-git-info').getRemoteUrl,
+    getCommitDateRange = require('./portfolio-git-info').getCommitDateRange,
+    consentCopy = () => require('./signup-copy').signupCopy(require('./signup-language').signupLanguage(require('./i18n').detectFlowLang())).consent,
+    normalizeDomain = require('./start-add-portfolio').normalizeDomain,
+    isValidEmail = require('./share').isValidEmail,
+    normalizeEmail = require('./share').normalizeEmail,
+  } = deps;
+
+  const requireSession = () => {
+    const session = loadAuthSession();
+    if (sessionStatus(session) !== 'active') {
+      throw new Error('no active Shakers session — sign in with social_signin_start (or run `shakers login`) first.');
+    }
+    return session;
+  };
+
+  // Mint a fresh hub JWT (email/better-auth sessions) so an expired token doesn't
+  // fail the inventory read — mirrors the CLI add-agent and usage-poll retry.
+  const refreshTokenFor = async () => {
+    const fresh = await ensureFreshSession(process.env);
+    return fresh ? { accessToken: fresh.accessToken, hubAccessToken: fresh.hubAccessToken } : null;
+  };
+
+  const requireEndpoint = (getter, name) => {
+    const endpoint = getter();
+    if (!endpoint) {
+      throw new Error(`no ${name} endpoint configured — set SHAKERS_CLI_INGEST_ENDPOINT.`);
+    }
+    return endpoint;
+  };
+
+  async function logout() {
+    const wasLoggedIn = loadAuthSession() !== null;
+    try { clearAuthSession(); } catch { /* idempotent — nothing to clear */ }
+    return { ok: true, wasLoggedIn };
+  }
+
+  async function listAddable() {
+    const session = requireSession();
+    const endpoint = requireEndpoint(getUsageDiscoveredInventoryEndpoint, 'discovered-inventory');
+    const inv = await requestDiscoveredInventoryWithRefresh(
+      { accessToken: session.accessToken, refreshToken: refreshTokenFor },
+      { endpoint, request: requestDiscoveredInventory },
+    );
+    if (!inv.ok) {
+      return { ok: false, reason: inv.reason || 'inventory-failed' };
+    }
+    return { ok: true, skills: inv.skills, agents: inv.agents };
+  }
+
+  async function addSkill(args = {}) {
+    const session = requireSession();
+    const endpoint = requireEndpoint(getSkillsDeclareEndpoint, 'skills-declare');
+    const result = await requestDeclareSkill(
+      { skillId: args.skillId, accessToken: session.accessToken, hubAccessToken: session.hubAccessToken },
+      { endpoint },
+    );
+    const skillExisted = !result.ok && result.reason === 'skill-exists';
+    if (!result.ok && !skillExisted) return { ok: false, reason: result.reason || 'declare-failed' };
+
+    const listEndpoint = getPortfoliosListEndpoint();
+    const updateEndpoint = getPortfolioUpdateEndpoint();
+    if (!listEndpoint || !updateEndpoint) return skillExisted ? { ok: true, skillId: args.skillId, alreadyExisted: true } : { ok: true, skillId: args.skillId };
+
+    const listed = await requestListPortfolios(
+      { accessToken: session.accessToken, hubAccessToken: session.hubAccessToken },
+      { endpoint: listEndpoint },
+    );
+    if (!listed.ok) return { ok: true, skillId: args.skillId };
+    const portfolios = listed.portfolios.map((p) => ({ id: p.id, name: p.name, type: p.type }));
+
+    const relatedIds = Array.isArray(args.relatedPortfolioIds) ? args.relatedPortfolioIds : [];
+    if (relatedIds.length === 0) return { ok: true, skillId: args.skillId, portfolios, ...(skillExisted ? { alreadyExisted: true } : {}) };
+
+    const related = [];
+    const relateFailures = [];
+    for (const portfolioId of relatedIds) {
+      const portfolio = listed.portfolios.find((p) => p.id === portfolioId);
+      if (!portfolio) {
+        relateFailures.push({ portfolioId, reason: 'unknown-portfolio' });
+        continue;
+      }
+      const skillIds = Array.from(new Set([...(portfolio.skillIds || []), args.skillId]));
+      const r = await requestUpdatePortfolioSkills(
+        { portfolioId, skillIds, hubAccessToken: session.hubAccessToken },
+        { endpoint: updateEndpoint },
+      );
+      if (r.ok) related.push(portfolioId);
+      else relateFailures.push({ portfolioId, reason: r.reason });
+    }
+    return { ok: true, skillId: args.skillId, portfolios, related, relateFailures, ...(skillExisted ? { alreadyExisted: true } : {}) };
+  }
+
+  async function inventoryWhatItDoes(accessToken, agentName) {
+    try {
+      const endpoint = getUsageDiscoveredInventoryEndpoint();
+      if (!endpoint) return undefined;
+      const inv = await requestDiscoveredInventoryWithRefresh(
+        { accessToken, refreshToken: refreshTokenFor },
+        { endpoint, request: requestDiscoveredInventory },
+      );
+      if (!inv.ok || !Array.isArray(inv.agents)) return undefined;
+      const match = inv.agents.find((a) => a && a.name === agentName);
+      return match && typeof match.whatItDoes === 'string' && match.whatItDoes
+        ? match.whatItDoes
+        : undefined;
+    } catch {
+      return undefined;
+    }
+  }
+
+  async function resolveExistingAgentId(session, agentName) {
+    const listEndpoint = getAgentsListEndpoint();
+    if (!listEndpoint) return null;
+    const listed = await requestListAgents(
+      { accessToken: session.accessToken, hubAccessToken: session.hubAccessToken },
+      { endpoint: listEndpoint },
+    );
+    if (!listed.ok) return null;
+    const wanted = String(agentName || '').toLowerCase();
+    const match = listed.agents.find((a) => a.name && a.name.toLowerCase() === wanted);
+    return match && match.id ? match.id : null;
+  }
+
+  async function addAgent(args = {}) {
+    const session = requireSession();
+    const endpoint = requireEndpoint(getAgentsDeclareEndpoint, 'agents-declare');
+    if (!args.agentName) throw new Error('agentName is required (from list_addable.agents[].name).');
+    const whatItDoes =
+      typeof args.whatItDoes === 'string'
+        ? args.whatItDoes
+        : await inventoryWhatItDoes(session.accessToken, args.agentName);
+    const result = await requestDeclareAgent(
+      {
+        name: args.agentName,
+        whatItDoes,
+        humanDecides: typeof args.humanDecides === 'string' ? args.humanDecides : undefined,
+        accessToken: session.accessToken,
+        hubAccessToken: session.hubAccessToken,
+      },
+      { endpoint },
+    );
+
+    let agentId = result.ok ? (result.agentId || null) : null;
+    let alreadyExisted = false;
+    if (!result.ok) {
+      const existingId = await resolveExistingAgentId(session, args.agentName);
+      if (!existingId) return { ok: false, reason: result.reason || 'declare-failed' };
+      agentId = existingId;
+      alreadyExisted = true;
+    }
+    const base = { ok: true, agentName: args.agentName, agentId };
+    if (alreadyExisted) base.alreadyExisted = true;
+
+    // Echo the talent's current experiences (id/name/type) so a follow-up call
+    // can relate by id — same shape/purpose as add_skill's `portfolios` echo.
+    const listEndpoint = getPortfoliosListEndpoint();
+    if (!listEndpoint) return base;
+    const listed = await requestListPortfolios(
+      { accessToken: session.accessToken, hubAccessToken: session.hubAccessToken },
+      { endpoint: listEndpoint },
+    );
+    if (!listed.ok) return base;
+    const portfolios = listed.portfolios.map((p) => ({ id: p.id, name: p.name, type: p.type }));
+
+    const relatedInput = Array.isArray(args.relatedPortfolios) ? args.relatedPortfolios : [];
+    if (relatedInput.length === 0 || !agentId) return { ...base, portfolios };
+
+    // ADR-041 replace-set: validate every portfolioId against the talent's own
+    // list, then PATCH the whole set in ONE call.
+    const items = [];
+    const relateFailures = [];
+    for (const entry of relatedInput) {
+      const portfolioId = entry && entry.portfolioId;
+      const portfolio = listed.portfolios.find((p) => p.id === portfolioId);
+      if (!portfolio) {
+        relateFailures.push({ portfolioId, reason: 'unknown-portfolio' });
+        continue;
+      }
+      items.push({ portfolioId });
+    }
+    let related = [];
+    if (items.length > 0) {
+      const relateEndpoint = getAgentPortfoliosEndpoint(agentId);
+      const r = await requestRelateAgentPortfolios(
+        { agentId, items, hubAccessToken: session.hubAccessToken },
+        { endpoint: relateEndpoint },
+      );
+      if (r.ok) related = items.map((it) => it.portfolioId);
+      else for (const it of items) relateFailures.push({ portfolioId: it.portfolioId, reason: r.reason });
+    }
+    return { ...base, portfolios, related, relateFailures };
+  }
+
+  // Sends the project only after the talent says yes to exactly what goes: name, web address, dates, client.
+  async function addProject(args = {}, ctx = {}) {
+    const session = requireSession();
+    const endpoint = requireEndpoint(getPortfoliosDeclareEndpoint, 'portfolios-declare');
+    const root = path.resolve(typeof args.root === 'string' && args.root ? args.root : process.cwd());
+    const name = typeof args.name === 'string' && args.name ? args.name : path.basename(root);
+    const type = args.type === 'EXPERIENCE' ? 'EXPERIENCE' : 'PORTFOLIO';
+    let url = typeof args.url === 'string' && args.url ? args.url : null;
+    if (!url) {
+      try { url = getRemoteUrl(root) || null; } catch { url = null; }
+    }
+    let startDate;
+    let endDate;
+    try { ({ startDate, endDate } = getCommitDateRange(root)); } catch { startDate = null; endDate = null; }
+    const clientName = typeof args.clientName === 'string' && args.clientName ? args.clientName : null;
+    const clientDomain = normalizeDomain(args.clientDomain) || null;
+    const description = typeof args.description === 'string' && args.description ? args.description : null;
+    const sent = { name, type, url, startDate, endDate, clientName, clientDomain, description };
+    const c = consentCopy();
+    const asked = await askConsent(ctx, {
+      tool: 'add_project',
+      key: `add_project:${root}:${JSON.stringify(sent)}`,
+      question: c.project({ folder: tildify(root), name, url, startDate, endDate, client: [clientName, clientDomain].filter(Boolean).join(', '), description }),
+      yes: c.yes,
+      no: c.no,
+      answer: args.answer,
+    });
+    if (asked.reply) return asked.reply;
+    if (!asked.granted) return { ok: false, reason: 'consent-declined', message: 'The talent said no: nothing was sent. Do not add the project.' };
+    const result = await requestDeclarePortfolio(
+      {
+        name,
+        type,
+        description: description || undefined,
+        url: url || undefined,
+        clientName: clientName || undefined,
+        clientDomain: clientDomain || undefined,
+        startDate: startDate || undefined,
+        endDate: endDate || undefined,
+        skillIds: Array.isArray(args.skillIds) ? args.skillIds : undefined,
+        accessToken: session.accessToken,
+        hubAccessToken: session.hubAccessToken,
+      },
+      { endpoint },
+    );
+    return result.ok ? { ok: true, name, type } : { ok: false, reason: result.reason || 'declare-failed' };
+  }
+
+  return [
+    {
+      name: 'logout',
+      title: 'Sign out of Shakers',
+      description: 'Signs you out by deleting the Shakers sign-in saved on this computer.',
+      guidance: "Sign the talent out of Shakers by clearing the persisted session. Idempotent — returns { ok: true, wasLoggedIn } whether or not a session existed.",
+      inputSchema: LOGOUT_SCHEMA,
+      handler: logout,
+    },
+    {
+      name: 'list_addable',
+      title: 'Skills and agents you can add',
+      description: 'Shows the skills and AI agents found in the AI analysis you sent to Shakers, so you can pick which ones go on your profile.',
+      guidance: "List the skills and AI agents that Shakers discovered from the talent's submitted ai_usage report and that can be added to their Shakers profile. Use it to offer choices before add_skill / add_agent. Present skills and agents to the talent by NAME only; skillId, agent code and catalogId are internal handles for the add_* tools — never show raw IDs or codes. Requires an active session.",
+      inputSchema: LIST_ADDABLE_SCHEMA,
+      handler: listAddable,
+    },
+    {
+      name: 'add_skill',
+      title: 'Add a skill to your profile',
+      description: 'Adds the skill you pick to your Shakers profile.',
+      guidance: "Add a discovered skill to the talent's Shakers profile by skillId (taken from list_addable). skillId is an internal handle — refer to the skill by its name when talking to the talent, never show the id. Optionally pass relatedPortfolioIds to relate it to one or more of the talent's portfolio experiences (matches the web's 'Relate to an experience' step) — the response always includes `portfolios` (id/name/type) so you can ask the talent which one(s) on a later call. If the talent has no portfolios yet, the skill is still added, unrelated. Requires an active session.",
+      inputSchema: ADD_SKILL_SCHEMA,
+      handler: addSkill,
+    },
+    {
+      name: 'add_agent',
+      title: 'Add an AI agent to your profile',
+      description: 'Adds the AI agent you pick, with the description you agree on, to your Shakers profile.',
+      guidance: "Add a discovered AI agent to the talent's Shakers profile by name (from list_addable). Optionally pass whatItDoes and humanDecides (what the talent does around the agent — supervision/validation). Optionally pass relatedPortfolios ({ portfolioId }) to relate it to the talent's experiences (matches the web's 'Relate to an experience' step) — the response always includes `portfolios` (id/name/type) so you can ask which one(s) on a later call. If the talent has no experiences yet, the agent is still added, unrelated. Requires an active session.",
+      inputSchema: ADD_AGENT_SCHEMA,
+      handler: addAgent,
+    },
+    {
+      name: 'add_project',
+      title: 'Add this project to your portfolio',
+      description: 'Reads the name of the project folder open here, the web address of its code and the dates of its first and last change. It asks you first, naming all of them, and only then sends them to Shakers as a new portfolio project.',
+      guidance: "Add the current repository to the talent's Shakers portfolio as a project. Name and URL default to the repo directory and its git remote, and the start/end dates are derived from the repo's git history. Optionally pass clientName and clientDomain (the client's website/domain, e.g. 'acme.com' — Shakers fetches the client logo from it). The tool asks the talent first, naming the folder, web address, dates and client it will send (a dialog when the client has one, otherwise it returns `say` to print word for word as your whole reply); nothing is sent until they answer yes. After a `say`, call it again with the same arguments and answer set to the option they pick. Never answer for them. Requires an active session. Any ids/codes in the result are internal handles for tools only — never show or mention them to the talent.",
+      inputSchema: ADD_PROJECT_SCHEMA,
+      handler: addProject,
+    },
+  ];
+}
+
+module.exports = {
+  makeOnboardingTools,
+  LOGOUT_SCHEMA,
+  LIST_ADDABLE_SCHEMA,
+  ADD_SKILL_SCHEMA,
+  ADD_AGENT_SCHEMA,
+  ADD_PROJECT_SCHEMA,
+};

package/src/mcp-portfolios-tools.js

@@ -0,0 +1,50 @@
+'use strict';
+
+// MCP: list the talent's experiences (type=EXPERIENCE) and portfolio pieces
+// (type=PORTFOLIO). Both read-only.
+
+const SCHEMA = { type: 'object', properties: {} };
+
+function makePortfolioTools(deps = {}) {
+  const {
+    fetchPortfolios = (opts) => require('./portfolios-client').fetchPortfolios({}, opts),
+    loadAuthSession = require('./auth-session-store').loadAuthSession,
+    sessionStatus = require('./auth-session-store').sessionStatus,
+  } = deps;
+
+  const requireLoginSession = (tool) => {
+    const session = loadAuthSession();
+    if (sessionStatus(session) !== 'active') {
+      throw new Error(`no active Shakers session — sign in with social_signin_start (or run \`shakers login\`) first (${tool} is session-gated).`);
+    }
+    return session;
+  };
+
+  const lister = (kind, tool) => async () => {
+    const session = requireLoginSession(tool);
+    const res = await fetchPortfolios({ hubAccessToken: session.hubAccessToken, kind });
+    if (!res.ok) return { ok: false, reason: res.reason };
+    return { ok: true, items: res.items };
+  };
+
+  return [
+    {
+      name: 'list_experiences',
+      title: 'Your work experience',
+      description: 'Shows the work experience on your Shakers profile.',
+      guidance: "List the talent's work experiences (company, role/title, dates, location, skills). Read-only. Requires an active session. Any ids in the result are internal handles for tools only — never show or mention them to the talent.",
+      inputSchema: SCHEMA,
+      handler: lister('experiences', 'list_experiences'),
+    },
+    {
+      name: 'list_portfolios',
+      title: 'Your portfolio',
+      description: 'Shows the portfolio projects on your Shakers profile.',
+      guidance: "List the talent's portfolio showcase pieces (name, dates, location, skills, link). Read-only. Requires an active session. Any ids in the result are internal handles for tools only — never show or mention them to the talent.",
+      inputSchema: SCHEMA,
+      handler: lister('portfolios', 'list_portfolios'),
+    },
+  ];
+}
+
+module.exports = { makePortfolioTools, SCHEMA };

package/src/mcp-profile-tools.js

@@ -0,0 +1,48 @@
+'use strict';
+
+// MCP: the talent's summary (role + rate + "My work with AI").
+
+const GET_PROFILE_SCHEMA = { type: 'object', properties: {} };
+
+function makeProfileTools(deps = {}) {
+  const {
+    runProfile = require('./profile-flow').runProfile,
+    makeProfileDeps = require('./profile-flow').makeProfileDeps,
+    loadAuthSession = require('./auth-session-store').loadAuthSession,
+    sessionStatus = require('./auth-session-store').sessionStatus,
+    getCatalog = require('./i18n').getCatalog,
+    detectFlowLang = require('./i18n').detectFlowLang,
+  } = deps;
+
+  const requireLoginSession = () => {
+    const session = loadAuthSession();
+    if (sessionStatus(session) !== 'active') {
+      throw new Error('no active Shakers session — sign in with social_signin_start (or run `shakers login`) first (get_profile is session-gated).');
+    }
+    return session;
+  };
+
+  async function getProfile() {
+    const session = requireLoginSession();
+    // A silent io: the tool returns structured data, not printed lines.
+    const io = { section() {}, notify() {}, error() {}, warn() {}, success() {}, withProgress: (_l, task) => task() };
+    const catalog = getCatalog(detectFlowLang());
+    return runProfile({ io, rawOut: () => {}, session, catalog, opts: {}, deps: makeProfileDeps() });
+  }
+
+  return [
+    {
+      name: 'get_profile',
+      title: 'Your Shakers profile',
+      description: 'Shows your main role, your rate and your "My work with AI" summary on Shakers.',
+      guidance: "Get the talent's summary: main role, per-project rate, and the 'My work with AI' read model (setup/usage tier+level, 3x3 cell, vision, how-I-work). Requires an active session. Present it in human terms; any internal ids/codes in the result are handles for tools only — never show or mention them to the talent.",
+      inputSchema: GET_PROFILE_SCHEMA,
+      handler: getProfile,
+    },
+  ];
+}
+
+module.exports = {
+  makeProfileTools,
+  GET_PROFILE_SCHEMA,
+};

package/src/mcp-prompts.js

@@ -0,0 +1,73 @@
+'use strict';
+
+// MCP prompts = in-client slash-commands. Each is a thin wrapper that injects a user turn
+// telling the assistant which Shakers tool(s) to use — the logic stays in the tools, so
+// there is no duplication. `buildMessages(args)` returns the prompts/get message list.
+
+function userText(text) {
+  return [{ role: 'user', content: { type: 'text', text } }];
+}
+
+// Only reference tools that exist in the FULL server; `available(toolNames)` hides a prompt
+// when its tool isn't registered (e.g. the --local scan-only server).
+const PROMPTS = [
+  {
+    name: 'ai_usage',
+    description: 'Evaluate and showcase how you work with AI (scans this machine, builds your "My work with AI").',
+    tools: ['ai_usage'],
+    buildMessages: () => userText(
+      'Evaluate how I work with AI for my Shakers profile. First ask me for consent and the email to attribute it to, then call the `ai_usage` tool and show me the resulting report verbatim. Never show internal ids/codes.',
+    ),
+  },
+  {
+    name: 'onboarding',
+    description: 'Sign up on Shakers from this chat: your CV and LinkedIn, a password or Google, and your profile filled in for you.',
+    tools: ['signup_start'],
+    buildMessages: (_args, lang) => userText(
+      `Sign me up on Shakers following the sign-up flow in your Shakers instructions. Start with \`signup_start\` (language: the one I write in; "${lang}" if I have not written anything yet) and show me its texts word for word. Ask me only the questions the tools return, with their options, and nothing you can infer. Never narrate internal steps or tool state to me, and speak only in my language.`,
+    ),
+  },
+  {
+    name: 'find_projects',
+    description: 'Find open Shakers projects/positions matched to you.',
+    tools: ['find_projects'],
+    buildMessages: () => userText(
+      'Find open Shakers positions that match me: call `find_projects` and summarize them by title/company (never show internal ids). Offer `save_project` / `show_project` for ones I like.',
+    ),
+  },
+  {
+    name: 'certify',
+    description: 'See which role dimensions you can certify and start a certification.',
+    tools: ['list_certifiable_dimensions'],
+    buildMessages: () => userText(
+      'Help me certify on Shakers: call `list_certifiable_dimensions`, present the dimensions I can certify by name, and guide me through certifying the one I pick.',
+    ),
+  },
+  {
+    name: 'ask',
+    description: 'Ask Alma, the Shakers AI assistant, a question.',
+    tools: ['alma_chat'],
+    arguments: [{ name: 'message', description: 'What to ask Alma.', required: false }],
+    buildMessages: (args = {}) => userText(
+      `Ask Alma (the Shakers assistant) with \`alma_chat\` and relay her answer as-is. My question: ${typeof args.message === 'string' && args.message ? args.message : '(ask me what I want to know first)'}`,
+    ),
+  },
+  {
+    name: 'my_profile',
+    description: 'Show your Shakers profile (role, rate, availability, "My work with AI").',
+    tools: ['get_profile'],
+    buildMessages: () => userText(
+      'Show my Shakers profile: call `get_profile` (and `get_rate` / `get_availability` if useful) and present it in plain terms. Any ids/codes are internal — never show them.',
+    ),
+  },
+];
+
+function makePrompts(toolNames = null, lang = 'en') {
+  const available = toolNames instanceof Set ? toolNames : null;
+  // Keep a prompt only if at least one of its tools is present in this server.
+  return PROMPTS
+    .filter((p) => !available || p.tools.some((t) => available.has(t)))
+    .map((p) => ({ ...p, buildMessages: (args) => p.buildMessages(args, lang) }));
+}
+
+module.exports = { makePrompts, PROMPTS };

package/src/mcp-rate-tools.js

@@ -0,0 +1,44 @@
+'use strict';
+
+// MCP: view the talent's rates (hourly and annual, as the web shows them). Read-only.
+
+const GET_RATE_SCHEMA = { type: 'object', properties: {} };
+
+function makeRateTools(deps = {}) {
+  const {
+    fetchPricingRate = (opts) => require('./rate-client').fetchPricingRate({}, opts),
+    loadAuthSession = require('./auth-session-store').loadAuthSession,
+    sessionStatus = require('./auth-session-store').sessionStatus,
+  } = deps;
+
+  const requireLoginSession = () => {
+    const session = loadAuthSession();
+    if (sessionStatus(session) !== 'active') {
+      throw new Error('no active Shakers session — sign in with social_signin_start (or run `shakers login`) first (get_rate is session-gated).');
+    }
+    return session;
+  };
+
+  async function getRate() {
+    const session = requireLoginSession();
+    const res = await fetchPricingRate({ hubAccessToken: session.hubAccessToken });
+    if (!res.ok) return { ok: false, reason: res.reason };
+    return { ok: true, pricing: res.pricing };
+  }
+
+  return [
+    {
+      name: 'get_rate',
+      title: 'Your rates',
+      description: 'Shows your hourly rate and your yearly target on Shakers.',
+      guidance: "View the talent's rates as the web shows them: partTimePrice is the hourly rate (per hour) and fullTimePrice the annual target (per year); a variant not selected is not offered. Read-only. Requires an active session. Show only the human-facing amounts/currency; any internal ids in the result are handles for tools only — never show or mention them to the talent.",
+      inputSchema: GET_RATE_SCHEMA,
+      handler: getRate,
+    },
+  ];
+}
+
+module.exports = {
+  makeRateTools,
+  GET_RATE_SCHEMA,
+};