shakers-cli 0.18.0 → 0.19.0

package/src/i18n.js

@@ -823,6 +823,42 @@ const catalogs = {
       faqsHeading: 'Preguntas frecuentes',
       done: 'Detalle completado.',
     },
+    apply: {
+      help:
+        'apply — aplica a un proyecto/posición con tu mensaje y tus respuestas a sus preguntas.\n\n'
+        + 'Uso:\n  apply <número|id> [--lang es|en]\n\n'
+        + 'Requiere una sesión activa (shakers login) y una terminal interactiva.\n',
+      loginRequired: '"apply" requiere una sesión activa.\n  Falta: iniciar sesión. Ejecuta primero: shakers login',
+      needsInteractive: 'Aplicar necesita una terminal interactiva: te pido tu mensaje y tus respuestas, y que confirmes antes de enviar. Desde un asistente de IA, usa la herramienta MCP apply_to_project.',
+      idRequired: 'Falta el proyecto. Uso: apply <número|id>.',
+      refNoCache: 'No hay un listado reciente. Ejecuta primero shakers find-projects y usa el número que aparece (o pasa un id).',
+      refOutOfRange: (count) => `Ese número no está en el último listado (hay ${count}). Ejecuta shakers find-projects otra vez.`,
+      loading: 'Cargando las preguntas de la candidatura…',
+      fetchFailed: (reason) => `No se pudieron obtener las preguntas (${reason}). Inténtalo de nuevo en un momento.`,
+      notFound: 'No se encontró ese proyecto/posición.',
+      notOpen: 'Este proyecto no admite tu candidatura ahora mismo: ya aplicaste, está cerrado o no está disponible para ti.',
+      untitled: 'Sin título',
+      companyLine: (name) => `Empresa: ${name}`,
+      mainMotivationFallback: '¿Cuál es tu principal motivación para aplicar?',
+      askMessage: (question) => `${question} (tu mensaje para el equipo; enter para dejarlo en blanco):`,
+      askOpen: (question) => `${question} (enter para no responder):`,
+      choiceHint: 'Flechas ↑/↓ para moverte · enter para elegir',
+      skipChoice: 'No responder',
+      summaryTitle: 'Esto es lo que se enviará',
+      titleLine: (title) => `Proyecto: ${title}`,
+      messageLine: (message) => `Mensaje: ${message}`,
+      empty: '(vacío)',
+      answerLine: (question, answer) => `${question}: ${answer}`,
+      sendNotice: (title) => `Se envían tu mensaje y tus respuestas para «${title}»: el cliente verá tu perfil de Shakers y se abre un chat con el equipo. Tu perfil no cambia.`,
+      reviewNotice: 'En este proyecto Shakers revisa tu candidatura antes de que la vea el cliente.',
+      confirm: '¿Enviar la candidatura? (s/n):',
+      cancelled: 'Cancelado. No se ha enviado nada.',
+      sending: 'Enviando tu candidatura…',
+      sent: 'Candidatura enviada. Puedes seguirla con shakers applications.',
+      sentPending: 'Candidatura enviada. Shakers la revisa antes de que la vea el cliente; puedes seguirla con shakers applications.',
+      alreadyApplied: (status) => (status ? `Ya aplicaste a este proyecto (estado: ${status}).` : 'Ya aplicaste a este proyecto.'),
+      failed: (reason) => `No se pudo enviar la candidatura (${reason}). Inténtalo de nuevo en un momento.`,
+    },
     savedPositions: {
       helpSave: 'save-project — guarda un proyecto/posición en tus guardados.\n\nUso:\n  save-project <número|id> [--json]\n\nRequiere una sesión activa (shakers login).',
       helpUnsave: 'unsave-project — quita un proyecto/posición de tus guardados.\n\nUso:\n  unsave-project <número|id> [--json]\n\nRequiere una sesión activa (shakers login).',
@@ -1228,6 +1264,7 @@ const catalogs = {
       },
     },
     trust: {
+      detectedAgents: 'Si confirmas, añado a tu perfil de Shakers los agentes marcados, solo su nombre y su descripción, y los clientes los verán en tu perfil. No leo ni subo nada más de este ordenador. Puedes quitarlos cuando quieras desde tu perfil en la web de Shakers.',
       uploadWarning: 'Antes de aprobar: se enviarían hasta 40 extractos literales de tus mensajes (correcciones y decisiones) y 20 comandos, de 200 caracteres como máximo cada uno, la configuración y la definición de tus agentes y recuentos de actividad. Se quita lo que parece un secreto, un email o una ruta, pero el filtro es aproximado: no lo apruebes si hay datos que no puedes compartir (de clientes, de tu empresa o de terceros).',
       cli: {
         'ai-usage': { before: 'Voy a analizar en este ordenador tus herramientas de IA, el historial de tus proyectos de código y tus conversaciones con asistentes de programación con IA (Claude Code, Codex, Gemini, Cursor, Continue, Cline/Roo, Aider, Pi, OpenCode). Si analizas un repo, solo cubre las conversaciones de ese repo; si eliges toda la máquina o es tu alta, todas las de este equipo. Antes de enviar nada a Shakers te enseño qué se enviaría y te pregunto. No lo uses en un equipo ni con conversaciones que tengan datos que no puedes compartir (de clientes, de tu empresa o de terceros).', after: 'Hecho. Si aprobaste la subida, un modelo de IA de un proveedor externo (OpenAI, Google o Anthropic) analiza lo enviado por encargo de Shakers para calcular tu evaluación y después se descarta; solo se guarda el resultado (niveles, puntuaciones, recuentos y los nombres de tus herramientas y agentes). Si no la aprobaste, no se ha subido nada a tu perfil. Revisión humana: «Solicitar revisión humana» en la web o talent@shakersworks.com; para pedir que se borre lo enviado, el mismo correo. Para dejar de enviar desde este equipo: `shakers ai-usage --consent-revoke`.' },
@@ -1235,12 +1272,13 @@ const catalogs = {
         share: { before: 'Voy a crear en este ordenador una tarjeta con tu informe de IA para compartir. No envío nada.', after: 'Hecho. La tarjeta está en este ordenador; no se ha enviado nada.' },
         report: { before: 'Voy a leer tu informe de IA (de Shakers o de tu último análisis en este ordenador) y a guardarlo como archivo en este ordenador. No cambio tu perfil.' },
         'add-skill': { before: 'Voy a leer las skills de tu último análisis en Shakers y a añadir a tu perfil las que elijas.', after: 'Hecho. Tu perfil de Shakers tiene las skills que elegiste.' },
-        'add-agent': { before: 'Voy a leer los agentes de tu último análisis en Shakers y a añadir a tu perfil el que elijas, con la descripción que apruebes.', after: 'Hecho. Tu perfil de Shakers tiene el agente que elegiste.' },
+        'add-agent': { before: 'Voy a leer los agentes de tu último análisis en Shakers y a añadir a tu perfil el que elijas, con la descripción que apruebes, o todos los nuevos de una vez si lo eliges.', after: 'Hecho. Tu perfil de Shakers tiene los agentes que elegiste.' },
         'add-project': { before: 'Voy a leer el nombre de esta carpeta, la dirección web de su código y las fechas de su primer y último cambio, y te pregunto antes de enviarlos a tu portfolio de Shakers. No envío tu código.', after: 'Hecho. El proyecto está en tu portfolio de Shakers.' },
         'add-role': { before: 'Voy a leer los roles de Shakers y a añadir a tu perfil el que elijas.', after: 'Hecho. Tu perfil de Shakers tiene el rol que elegiste.' },
         'change-role': { before: 'Voy a leer tus roles de Shakers y a guardar como principal el que elijas.', after: 'Hecho. Tu rol principal está guardado en Shakers.' },
         'find-projects': { before: 'Solo leo de Shakers los proyectos que encajan contigo; no cambio nada.' },
         'show-project': { before: 'Solo leo de Shakers el detalle del proyecto; no cambio nada.' },
+        apply: { before: 'Voy a leer de Shakers las preguntas de este proyecto y, si confirmas, enviar tu mensaje y tus respuestas: el cliente verá tu perfil de Shakers y se abre un chat con el equipo. Si el proyecto lo pide, Shakers revisa tu candidatura antes de que la vea el cliente. No cambio tu perfil.', after: 'Hecho. Tu candidatura está en Shakers; puedes seguirla con shakers applications.' },
         'save-project': { before: 'Voy a guardar este proyecto en tus proyectos guardados de Shakers.', after: 'Hecho. El proyecto está en tus guardados.' },
         'unsave-project': { before: 'Voy a quitar este proyecto de tus proyectos guardados de Shakers.', after: 'Hecho. El proyecto ya no está en tus guardados.' },
         invitations: { before: 'Solo leo tus invitaciones de Shakers; no cambio nada.' },
@@ -1474,6 +1512,16 @@ const catalogs = {
       agentDeclaredSuccess: (name) => `✓ "${name}" añadido a tu perfil.`,
       agentDeclareFailed: (reason) => `✗ No se pudo añadir el agente a tu perfil: ${reason}`,
       agentHubSessionExpired: 'Tu sesión de Shakers ha caducado mientras añadíamos el agente a tu perfil.',
+      addAllDetectedEntry: (n) => `Añadir todos los agentes detectados que aún no tienes (${n})`,
+      detectedAgentsHeading: 'Agentes detectados que aún no están en tu perfil:',
+      detectedAgentsHint: 'Flechas ↑/↓ para moverte · espacio para marcar o desmarcar · a para todos · enter para añadir los marcados · esc para no añadir ninguno',
+      detectedAgentsNeedsYes: (n) => `Hay ${n} agente(s) detectado(s) que aún no están en tu perfil. Sin terminal no los añado; para añadirlos todos: shakers add-agent --all --yes`,
+      detectedAgentsCheckFailed: (reason) => `No se pudo comprobar qué agentes tienes ya en tu perfil: ${reason} No añado ninguno para no duplicarlos; inténtalo más tarde con shakers add-agent --all.`,
+      detectedAgentsAllOnProfile: 'Todos los agentes detectados ya están en tu perfil.',
+      detectedAgentsDeclaring: 'Añadiendo los agentes a tu perfil…',
+      detectedAgentsHubSessionExpired: 'Tu sesión de Shakers ha caducado mientras añadíamos los agentes a tu perfil.',
+      detectedAgentFailed: (name, reason) => `✗ No se pudo añadir "${name}": ${reason}`,
+      detectedAgentsSummary: (added, total) => `${added} de ${total} agente(s) añadido(s) a tu perfil.`,
       agentRelateNoPortfolios: 'Todavía no tienes experiencias en tu perfil, así que el agente se ha añadido sin relacionar. Puedes añadir una con "Añadir proyecto al portfolio" y relacionarlo más tarde.',
       agentRelateAsk: (agentName) => `¿Quieres relacionar "${agentName}" con alguna de tus experiencias? (s/n):`,
       agentRelateSelectHeading: (agentName) => `Relaciona "${agentName}" con una o varias experiencias:`,
@@ -2502,6 +2550,42 @@ const catalogs = {
       faqsHeading: 'FAQs',
       done: 'Detail complete.',
     },
+    apply: {
+      help:
+        'apply — apply to a project/position with your message and your answers to its questions.\n\n'
+        + 'Usage:\n  apply <number|id> [--lang es|en]\n\n'
+        + 'Requires an active session (shakers login) and an interactive terminal.\n',
+      loginRequired: '"apply" requires an active session.\n  Missing: sign-in. Run `shakers login` first.',
+      needsInteractive: 'Applying needs an interactive terminal: I ask for your message and your answers, and for your confirmation before sending. From an AI assistant, use the apply_to_project MCP tool.',
+      idRequired: 'The project is missing. Usage: apply <number|id>.',
+      refNoCache: 'There is no recent listing. Run shakers find-projects first and use the number it shows (or pass an id).',
+      refOutOfRange: (count) => `That number is not in the last listing (it has ${count}). Run shakers find-projects again.`,
+      loading: 'Loading the application questions…',
+      fetchFailed: (reason) => `Could not get the questions (${reason}). Try again in a moment.`,
+      notFound: 'That project/position was not found.',
+      notOpen: 'This project does not take your application right now: you already applied, it is closed or it is not available to you.',
+      untitled: 'Untitled',
+      companyLine: (name) => `Company: ${name}`,
+      mainMotivationFallback: "What's your main motivation to apply?",
+      askMessage: (question) => `${question} (your message for the team; enter to leave it blank):`,
+      askOpen: (question) => `${question} (enter to skip):`,
+      choiceHint: 'Arrows ↑/↓ to move · enter to pick',
+      skipChoice: 'Skip',
+      summaryTitle: 'This is what will be sent',
+      titleLine: (title) => `Project: ${title}`,
+      messageLine: (message) => `Message: ${message}`,
+      empty: '(empty)',
+      answerLine: (question, answer) => `${question}: ${answer}`,
+      sendNotice: (title) => `Your message and your answers for "${title}" are sent: the client will see your Shakers profile and a chat with the team opens. Your profile does not change.`,
+      reviewNotice: 'On this project Shakers reviews your application before the client sees it.',
+      confirm: 'Send the application? (y/n):',
+      cancelled: 'Cancelled. Nothing was sent.',
+      sending: 'Sending your application…',
+      sent: 'Application sent. You can follow it with shakers applications.',
+      sentPending: 'Application sent. Shakers reviews it before the client sees it; you can follow it with shakers applications.',
+      alreadyApplied: (status) => (status ? `You already applied to this project (status: ${status}).` : 'You already applied to this project.'),
+      failed: (reason) => `Could not send the application (${reason}). Try again in a moment.`,
+    },
     savedPositions: {
       helpSave: 'save-project — bookmark a project/position.\n\nUsage:\n  save-project <number|id> [--json]\n\nRequires an active session (shakers login).',
       helpUnsave: 'unsave-project — remove a project/position from your saved list.\n\nUsage:\n  unsave-project <number|id> [--json]\n\nRequires an active session (shakers login).',
@@ -2903,6 +2987,7 @@ const catalogs = {
       },
     },
     trust: {
+      detectedAgents: 'If you confirm, I add the marked agents to your Shakers profile, only their name and description, and clients will see them on your profile. Nothing else is read or uploaded from this computer. You can remove them any time from your profile on the Shakers website.',
       uploadWarning: "Before you approve: up to 40 literal excerpts of your messages (corrections and decisions) and 20 commands, 200 characters max each, your agents' configuration and definitions, and activity counts would be sent. Anything that looks like a secret, an email or a path is removed, but the filter is approximate: do not approve it if there is data you are not allowed to share (client, employer or third-party data).",
       cli: {
         'ai-usage': { before: "I am going to analyse on this computer your AI tools, the history of your code projects and your conversations with AI coding assistants (Claude Code, Codex, Gemini, Cursor, Continue, Cline/Roo, Aider, Pi, OpenCode). Analysing a repo covers only that repo's conversations; choosing the whole machine, or signing up, covers every conversation on this computer. Before sending anything to Shakers I show you what would be sent and ask you. Do not use it on a computer or with conversations holding data you are not allowed to share (client, employer or third-party data).", after: 'Done. If you approved the upload, an AI model from an external provider (OpenAI, Google or Anthropic) analyses what was sent on behalf of Shakers to compute your evaluation and then it is discarded; only the result is kept (levels, scores, counts and the names of your tools and agents). If you did not approve it, nothing went to your profile. Human review: "Request human review" on the web or talent@shakersworks.com; to ask for deletion of what was sent, the same email. To stop sending from this computer: `shakers ai-usage --consent-revoke`.' },
@@ -2910,12 +2995,13 @@ const catalogs = {
         share: { before: 'I am going to create on this computer a card with your AI report to share. I send nothing.', after: 'Done. The card is on this computer; nothing was sent.' },
         report: { before: 'I am going to read your AI report (from Shakers or from your last analysis on this computer) and save it as a file on this computer. I do not change your profile.' },
         'add-skill': { before: 'I am going to read the skills from your last analysis on Shakers and add the ones you pick to your profile.', after: 'Done. Your Shakers profile has the skills you picked.' },
-        'add-agent': { before: 'I am going to read the agents from your last analysis on Shakers and add the one you pick to your profile, with the description you approve.', after: 'Done. Your Shakers profile has the agent you picked.' },
+        'add-agent': { before: 'I am going to read the agents from your last analysis on Shakers and add the one you pick to your profile, with the description you approve, or every new one at once if you choose so.', after: 'Done. Your Shakers profile has the agents you picked.' },
         'add-project': { before: 'I am going to read this folder\'s name, the web address of its code and the dates of its first and last change, and ask you before sending them to your Shakers portfolio. I do not send your code.', after: 'Done. The project is in your Shakers portfolio.' },
         'add-role': { before: 'I am going to read the Shakers roles and add the one you pick to your profile.', after: 'Done. Your Shakers profile has the role you picked.' },
         'change-role': { before: 'I am going to read your Shakers roles and save the one you pick as your main role.', after: 'Done. Your main role is saved on Shakers.' },
         'find-projects': { before: 'I only read from Shakers the projects that fit you; I change nothing.' },
         'show-project': { before: 'I only read the project details from Shakers; I change nothing.' },
+        apply: { before: 'I am going to read the questions of this project from Shakers and, if you confirm, send your message and your answers: the client will see your Shakers profile and a chat with the team opens. If the project asks for it, Shakers reviews your application before the client sees it. I do not change your profile.', after: 'Done. Your application is on Shakers; you can follow it with shakers applications.' },
         'save-project': { before: 'I am going to save this project to your saved projects on Shakers.', after: 'Done. The project is in your saved projects.' },
         'unsave-project': { before: 'I am going to remove this project from your saved projects on Shakers.', after: 'Done. The project is no longer in your saved projects.' },
         invitations: { before: 'I only read your Shakers invitations; I change nothing.' },
@@ -3153,6 +3239,16 @@ const catalogs = {
       agentDeclaredSuccess: (name) => `✓ "${name}" added to your profile.`,
       agentDeclareFailed: (reason) => `✗ Could not add the agent to your profile: ${reason}`,
       agentHubSessionExpired: 'Your Shakers session expired while we were adding the agent to your profile.',
+      addAllDetectedEntry: (n) => `Add every detected agent you do not have yet (${n})`,
+      detectedAgentsHeading: 'Detected agents that are not on your profile yet:',
+      detectedAgentsHint: 'Arrows ↑/↓ to move · space to mark or unmark · a for all · enter to add the marked ones · esc to add none',
+      detectedAgentsNeedsYes: (n) => `${n} detected agent(s) are not on your profile yet. Without a terminal I do not add them; to add them all: shakers add-agent --all --yes`,
+      detectedAgentsCheckFailed: (reason) => `Could not check which agents are already on your profile: ${reason} I add none so they are not duplicated; try again later with shakers add-agent --all.`,
+      detectedAgentsAllOnProfile: 'Every detected agent is already on your profile.',
+      detectedAgentsDeclaring: 'Adding the agents to your profile…',
+      detectedAgentsHubSessionExpired: 'Your Shakers session expired while we were adding the agents to your profile.',
+      detectedAgentFailed: (name, reason) => `✗ Could not add "${name}": ${reason}`,
+      detectedAgentsSummary: (added, total) => `${added} of ${total} agent(s) added to your profile.`,
       // AFTER the agent is declared, offer to relate it to the experiences/projects the talent already declared (portfolioId only).
       agentRelateNoPortfolios: "You don't have any experiences in your profile yet, so the agent was added without a relation. Add one with \"Add project to portfolio\" and relate it later.",
       agentRelateAsk: (agentName) => `Do you want to relate "${agentName}" to any of your experiences? (y/n):`,

package/src/mcp-ai-usage-tool.js

@@ -313,7 +313,7 @@ function makeAiUsageTools(deps = {}) {
       aiProfile,
       relayVerbatim: [...confirmation, reviewTexts.resultText(review.lang, aiProfile.status === 'ready' ? aiProfile.preview : null, { explained })].join('\n\n'),
       next: enrichment === 'pending' || aiProfile.status !== 'ready' ? 'ai_usage_result' : null,
-      message: `Uploaded. ${VERBATIM} Then show \`text\`, the full report, verbatim.${enrichment === 'pending' || aiProfile.status !== 'ready' ? ' Shakers is still evaluating (normal, not an error): call ai_usage_result in a few minutes for the result and its explanation.' : ''}`,
+      message: `Uploaded. ${VERBATIM} Then show \`text\`, the full report, verbatim.${enrichment === 'pending' || aiProfile.status !== 'ready' ? ' Shakers is still evaluating (normal, not an error): call ai_usage_result in a few minutes for the result and its explanation.' : ''}${hasAgents && !explained ? ' Then call add_detected_agents to offer adding the detected agents to the profile.' : ''}`,
       display: {
         tier: { key: maturity.tierKey, name: maturity.tierName, setupLevel: maturity.name, score: maturity.score },
         aiProfile: {

package/src/mcp-apply-tools.js

@@ -0,0 +1,152 @@
+'use strict';
+
+const ID_PROPERTY = { type: 'string', description: 'Position id (UUID or legacy Mongo id) from find_projects or show_project. An internal handle: never show it to the talent.' };
+
+const PREPARE_APPLICATION_SCHEMA = {
+  type: 'object',
+  properties: { id: ID_PROPERTY },
+  required: ['id'],
+};
+
+const APPLY_TO_PROJECT_SCHEMA = {
+  type: 'object',
+  properties: {
+    id: ID_PROPERTY,
+    message: { type: 'string', description: "The talent's own message for the team, in their words, answering mainMotivationQuestion. Never write it for them." },
+    answers: {
+      type: 'array',
+      description: 'The answers the talent gave, one per question they answered; leave out the ones they skipped.',
+      items: {
+        type: 'object',
+        properties: {
+          question: { type: 'integer', description: 'The question number from prepare_application.' },
+          answer: { type: 'string', description: 'For OPEN, the talent\'s text. For MULTIPLE_CHOICE, exactly one of that question\'s options.' },
+        },
+        required: ['question', 'answer'],
+      },
+    },
+    confirm: { type: 'boolean', description: 'true ONLY after the talent explicitly said yes to the summary this tool returned for these exact arguments.' },
+  },
+  required: ['id'],
+};
+
+function parseAnswers(raw, questions) {
+  const answers = [];
+  const invalid = [];
+  for (const entry of Array.isArray(raw) ? raw : []) {
+    const q = entry && Number.isInteger(entry.question) ? questions[entry.question - 1] : null;
+    const said = entry && typeof entry.answer === 'string' ? entry.answer.trim() : '';
+    if (!q) { invalid.push({ question: entry && entry.question, reason: 'unknown-question' }); continue; }
+    if (!said) continue;
+    if (q.type === 'MULTIPLE_CHOICE') {
+      const option = q.options.find((o) => o.toLowerCase() === said.toLowerCase());
+      if (!option) { invalid.push({ question: entry.question, reason: 'not-an-option', options: q.options }); continue; }
+      answers.push({ question: q.text, answer: [option] });
+    } else {
+      answers.push({ question: q.text, answer: said });
+    }
+  }
+  return { answers, invalid };
+}
+
+function makeApplyTools(deps = {}) {
+  const {
+    loadApplication = (opts) => require('./apply-client').loadApplication({}, opts),
+    submitApplication = (opts) => require('./apply-client').submitApplication({}, opts),
+    applicationSummary = require('./apply-client').applicationSummary,
+    loadAuthSession = require('./auth-session-store').loadAuthSession,
+    sessionStatus = require('./auth-session-store').sessionStatus,
+    applyCopy = () => require('./signup-copy').applyCopy(require('./signup-language').signupLanguage(require('./i18n').detectFlowLang())),
+  } = deps;
+
+  const shownSummaries = new Set();
+
+  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 (this tool is session-gated).');
+    }
+    return session;
+  };
+
+  async function readApplication(args) {
+    const session = requireLoginSession();
+    const positionId = typeof args.id === 'string' ? args.id.trim() : '';
+    if (!positionId) return { session, result: { ok: false, reason: 'no-id' } };
+    const app = await loadApplication({ hubAccessToken: session.hubAccessToken, positionId });
+    if (!app.ok) return { session, result: { ok: false, reason: app.reason } };
+    if (!app.open) return { session, result: { ok: false, reason: 'not-open', relayVerbatim: applyCopy().notOpen, message: 'Nothing was sent. Print relayVerbatim word for word.' } };
+    return { session, positionId, app };
+  }
+
+  async function prepareApplication(args = {}) {
+    const { result, app } = await readApplication(args);
+    if (result) return result;
+    const t = applyCopy();
+    return {
+      ok: true,
+      title: app.title,
+      company: app.company,
+      mainMotivationQuestion: app.mainMotivationQuestion || t.mainMotivationFallback,
+      questions: app.questions.map((q, i) => ({ number: i + 1, ...q })),
+      reviewedByShakers: !!app.doubleCheck && app.doubleCheck !== 'NO',
+      message: 'Nothing has been sent. Ask the talent the mainMotivationQuestion and then each question, one at a time, in their language; for MULTIPLE_CHOICE list its options numbered. Every answer is optional. Use only what the talent writes: never invent, complete or improve the message or the answers. Then call apply_to_project with them.',
+    };
+  }
+
+  async function applyToProject(args = {}) {
+    const { session, positionId, app, result } = await readApplication(args);
+    if (result) return result;
+    const t = applyCopy();
+    const { answers, invalid } = parseAnswers(args.answers, app.questions);
+    if (invalid.length) {
+      return { ok: false, reason: 'invalid-answers', invalid, message: 'Nothing was sent. Some answers do not match the questions from prepare_application: ask the talent again for those and call apply_to_project with the question number and, for MULTIPLE_CHOICE, one of its options exactly.' };
+    }
+    const message = typeof args.message === 'string' ? args.message.trim() : '';
+    const key = JSON.stringify([positionId, message, answers]);
+    if (args.confirm !== true || !shownSummaries.has(key)) {
+      shownSummaries.add(key);
+      return {
+        ok: false,
+        reason: 'confirmation-required',
+        say: [...applicationSummary(t, app, { message, answers }), t.confirmQuestion].join('\n\n'),
+        message: "Nothing has been sent. Print say word for word and wait for the talent. Call apply_to_project again with exactly the same arguments and confirm:true only if the talent explicitly says yes to sending it; if they want changes, collect them and call it without confirm. Only the talent decides: never confirm on their behalf, and never invent the message or the answers.",
+      };
+    }
+    shownSummaries.delete(key);
+    const mainMotivationQuestion = app.mainMotivationQuestion || t.mainMotivationFallback;
+    const res = await submitApplication({ hubAccessToken: session.hubAccessToken, positionId, message, answers, mainMotivationQuestion });
+    if (!res.ok) {
+      if (res.reason === 'already-applied') return { ok: false, reason: res.reason, applicationStatus: res.applicationStatus, relayVerbatim: t.alreadyApplied(res.applicationStatus), message: 'Print relayVerbatim word for word.' };
+      if (res.reason === 'position-unavailable') return { ok: false, reason: res.reason, relayVerbatim: t.notOpen, message: 'Print relayVerbatim word for word.' };
+      return { ok: false, reason: res.reason, message: 'The application was not sent. Tell the talent it could not be sent and that they can try again later.' };
+    }
+    return {
+      ok: true,
+      status: res.status,
+      relayVerbatim: res.status === 'PENDING' ? t.sentPending : t.sent,
+      message: 'Print relayVerbatim word for word.',
+    };
+  }
+
+  return [
+    {
+      name: 'prepare_application',
+      title: 'See what applying to a project asks',
+      description: 'Reads the questions you are asked when you apply to a Shakers project. It sends nothing.',
+      guidance: "Read-only first step to apply to a project/Position as an already-registered talent: returns its title, company, the main motivation question and the extra questions (OPEN or MULTIPLE_CHOICE with options), numbered. If reason is not-open, the talent already applied or the project is closed: print relayVerbatim and stop. Then ask the talent each question in the chat and call apply_to_project with their own words. Never invent or complete answers. Requires an active session and the position id.",
+      inputSchema: PREPARE_APPLICATION_SCHEMA,
+      handler: prepareApplication,
+    },
+    {
+      name: 'apply_to_project',
+      title: 'Apply to a project',
+      description: 'Shows you exactly what your application to a Shakers project will send and sends it only after you say yes.',
+      guidance: "Apply to a project/Position for the talent with their message and their answers to the prepare_application questions. Only the message and the answers are sent: never budget, phone, location or availability. Call it first without confirm: it returns `say`, the literal summary and the question, to print word for word. Only when the talent explicitly answers yes, call it again with exactly the same arguments and confirm:true; a confirm without that summary shown counts for nothing. Never confirm on the talent's behalf and never invent, complete or improve their message or answers. Print relayVerbatim word for word. Requires an active session and the position id, which is an internal handle never shown to the talent.",
+      inputSchema: APPLY_TO_PROJECT_SCHEMA,
+      handler: applyToProject,
+    },
+  ];
+}
+
+module.exports = { makeApplyTools, parseAnswers, PREPARE_APPLICATION_SCHEMA, APPLY_TO_PROJECT_SCHEMA };

package/src/mcp-onboarding-tools.js

@@ -42,6 +42,31 @@ const ADD_AGENT_SCHEMA = {
   required: ['agentName'],
 };
 
+const ADD_DETECTED_AGENTS_SCHEMA = {
+  type: 'object',
+  properties: {
+    selection: { type: 'string', description: 'Exactly what the talent typed in reply to the numbered list this tool returned: numbers such as "1 3", "all" or "none", in their words. Never set it yourself.' },
+  },
+};
+
+const ALL_WORDS = new Set(['all', 'todos', 'todas', 'tutti', 'tutte', 'tudo']);
+const NONE_WORDS = new Set(['none', 'ninguno', 'ninguna', 'nada', 'nessuno', 'nessuna', 'nenhum', 'nenhuma', '0']);
+
+function parseSelection(raw, agents) {
+  const said = typeof raw === 'string' ? raw.normalize('NFD').replace(/\p{M}/gu, '').toLowerCase().replace(/[«»"'.]/g, ' ').trim() : '';
+  if (!said) return null;
+  if (ALL_WORDS.has(said)) return agents;
+  if (NONE_WORDS.has(said)) return [];
+  const tokens = said.split(/[\s,;]+|\b(?:y|and|e)\b/).map((t) => t.trim()).filter(Boolean);
+  const picked = new Set();
+  for (const token of tokens) {
+    const n = /^\d+$/.test(token) ? Number(token) : NaN;
+    if (!Number.isInteger(n) || n < 1 || n > agents.length) return null;
+    picked.add(n - 1);
+  }
+  return picked.size ? agents.filter((_, i) => picked.has(i)) : null;
+}
+
 const ADD_PROJECT_SCHEMA = {
   type: 'object',
   properties: {
@@ -79,6 +104,9 @@ function makeOnboardingTools(deps = {}) {
     requestDeclareAgent = require('./agents-client').requestDeclareAgent,
     requestListAgents = require('./agents-client').requestListAgents,
     requestRelateAgentPortfolios = require('./agents-client').requestRelateAgentPortfolios,
+    newDetectedAgents = require('./detected-agents').newDetectedAgents,
+    declareDetectedAgents = require('./detected-agents').declareDetectedAgents,
+    detectedAgentsCopy = () => require('./signup-copy').detectedAgentsCopy(require('./signup-language').signupLanguage(require('./i18n').detectFlowLang())),
     requestDeclarePortfolio = require('./portfolio-client').requestDeclarePortfolio,
     requestListPortfolios = require('./portfolio-client').requestListPortfolios,
     requestUpdatePortfolioSkills = require('./portfolio-client').requestUpdatePortfolioSkills,
@@ -275,6 +303,57 @@ function makeOnboardingTools(deps = {}) {
     return { ...base, portfolios, related, relateFailures };
   }
 
+  // The detected agents offered last, so a selection counts only for the list the talent was shown.
+  let offeredAgents = null;
+
+  async function addDetectedAgents(args = {}) {
+    const session = requireSession();
+    const inventoryEndpoint = requireEndpoint(getUsageDiscoveredInventoryEndpoint, 'discovered-inventory');
+    const listEndpoint = requireEndpoint(getAgentsListEndpoint, 'agents-list');
+    const declareEndpoint = requireEndpoint(getAgentsDeclareEndpoint, 'agents-declare');
+    const c = detectedAgentsCopy();
+    const inv = await requestDiscoveredInventoryWithRefresh(
+      { accessToken: session.accessToken, refreshToken: refreshTokenFor },
+      { endpoint: inventoryEndpoint, request: requestDiscoveredInventory },
+    );
+    if (!inv.ok) return { ok: false, reason: inv.reason || 'inventory-failed', message: 'Nothing was added: the detected agents could not be read.' };
+    const listed = await requestListAgents(
+      { accessToken: session.accessToken, hubAccessToken: session.hubAccessToken },
+      { endpoint: listEndpoint },
+    );
+    if (!listed.ok) return { ok: false, reason: listed.reason, message: 'Nothing was added: the agents already on the profile could not be checked, so none are added to avoid duplicates.' };
+    const agents = newDetectedAgents(inv.agents, listed.agents);
+    if (agents.length === 0) {
+      offeredAgents = null;
+      return { ok: true, added: [], relayVerbatim: c.allOnProfile, message: 'Nothing to add. Print relayVerbatim word for word.' };
+    }
+    const offered = offeredAgents && JSON.stringify(offeredAgents.map((a) => a.name)) === JSON.stringify(agents.map((a) => a.name));
+    const chosen = offered ? parseSelection(args.selection, agents) : null;
+    if (!chosen) {
+      offeredAgents = agents;
+      return {
+        ok: false,
+        reason: 'selection-required',
+        say: [c.intro, agents.map((a, i) => `${i + 1}. ${a.name}`).join('\n'), c.question].join('\n\n'),
+        message: 'Nothing has been added. Print say word for word and stop: the talent replies with numbers (such as "1 3"), "all" or "none". Then call add_detected_agents again with selection = exactly what the talent typed. Only the talent decides: never choose, confirm or fill in selection for them, and never call it with a selection they did not type.',
+      };
+    }
+    offeredAgents = null;
+    if (chosen.length === 0) return { ok: true, added: [], relayVerbatim: c.noneChosen, message: 'Nothing was added. Print relayVerbatim word for word.' };
+    const { added, failed } = await declareDetectedAgents(chosen, session, { endpoint: declareEndpoint, declare: requestDeclareAgent });
+    const expired = failed.some((f) => f.reason === 'hub-session-expired');
+    return {
+      ok: added.length > 0,
+      added: added.map((a) => a.name),
+      failed: failed.map((f) => ({ name: f.agent.name, reason: f.reason })),
+      relayVerbatim: [
+        added.length ? c.added(added.map((a) => a.name).join(', ')) : null,
+        failed.length ? c.failed(failed.map((f) => f.agent.name).join(', ')) : null,
+      ].filter(Boolean).join('\n'),
+      message: `Print relayVerbatim word for word.${expired ? ' The Shakers session expired: ask the talent to sign in again (social_signin_start), then call add_detected_agents again to offer the ones still missing.' : ''}`,
+    };
+  }
+
   // 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();
@@ -356,6 +435,14 @@ function makeOnboardingTools(deps = {}) {
       inputSchema: ADD_AGENT_SCHEMA,
       handler: addAgent,
     },
+    {
+      name: 'add_detected_agents',
+      title: 'Add your detected agents',
+      description: 'Lists the AI agents found in your analysis that are not on your Shakers profile yet and adds the ones you choose, only their name and description.',
+      guidance: "Offer the talent to add, in one step, the AI agents detected by their submitted ai_usage report that are not on their Shakers profile yet (agents already there are skipped by name). No experience or portfolio is needed or related. Call it without selection: it returns `say`, a numbered list and the question, to print word for word; the talent replies with numbers, all or none. Then call it again with selection set to exactly what the talent typed. The talent's reply is the only confirmation: never pick, confirm or fill in selection on their behalf, and a selection counts only after the list was shown. Print relayVerbatim word for word. Offer it after an ai_usage_upload that sent agents. Requires an active session.",
+      inputSchema: ADD_DETECTED_AGENTS_SCHEMA,
+      handler: addDetectedAgents,
+    },
     {
       name: 'add_project',
       title: 'Add this project to your portfolio',
@@ -373,5 +460,7 @@ module.exports = {
   LIST_ADDABLE_SCHEMA,
   ADD_SKILL_SCHEMA,
   ADD_AGENT_SCHEMA,
+  ADD_DETECTED_AGENTS_SCHEMA,
   ADD_PROJECT_SCHEMA,
+  parseSelection,
 };