@ttctl/mcp 0.0.0 → 0.1.0-rc.2

package/dist/tools/profile/shared.js

@@ -0,0 +1,128 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ConfigError, DateInputError, TtctlError, profile, resolveConfig } from "@ttctl/core";
+import { z } from "zod";
+import { emitMcpAuthResolve } from "../../diagnostic.js";
+import { ttctlErrorToToolResponse } from "../../errors.js";
+/**
+ * Zod schema for sub-domain `--from` / `--to` / `--issued` / `--expires` /
+ * other date-flavored flags. Accepts ISO-8601 (`YYYY-MM-DD`) or year-only
+ * (`YYYY`); semantic validation (real calendar dates, year range) happens
+ * later inside `parseDateInput` from `@ttctl/core`. Hoisted here so the
+ * four sub-domain tool files share a single source of truth.
+ */
+export const dateInput = z
+    .string()
+    .regex(/^(\d{4}|\d{4}-\d{2}-\d{2})$/, "expected ISO-8601 date (YYYY-MM-DD) or year (YYYY)");
+/**
+ * Render a JSON-serialized success response. Tools return structured data
+ * as JSON in the `text` content field — MCP-aware LLM clients can parse
+ * it; non-aware clients see human-readable JSON. The same payload is
+ * mirrored into `structuredContent` so tools declaring an `outputSchema`
+ * (#226) get SDK-validated structured output without per-tool plumbing.
+ *
+ * `structuredContent` is populated only when `payload` is an object —
+ * the MCP SDK's `structuredContent` slot expects an object shape, and
+ * array / primitive payloads stay in the `text` slot only.
+ */
+export function jsonSuccess(payload) {
+    const response = {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+    };
+    if (payload !== null && typeof payload === "object" && !Array.isArray(payload)) {
+        response.structuredContent = payload;
+    }
+    return response;
+}
+/**
+ * Render a plain-text success response (useful for verbs like `remove` /
+ * `highlight` whose output is a confirmation, not structured data). Use
+ * {@link textWithStructuredSuccess} when the tool also declares an
+ * `outputSchema` requiring a typed acknowledgment.
+ */
+export function textSuccess(text) {
+    return { content: [{ type: "text", text }] };
+}
+/**
+ * Render a confirmation line as the `text` content slot while also
+ * publishing a typed acknowledgment via `structuredContent`. Used by
+ * `*_remove` tools (#226) where the human-readable text stays for
+ * compatibility and the structured payload matches the tool's declared
+ * `outputSchema`.
+ */
+export function textWithStructuredSuccess(text, structuredContent) {
+    return {
+        content: [{ type: "text", text }],
+        structuredContent,
+    };
+}
+/**
+ * Map a domain error from any sub-domain into an MCP tool-error response.
+ *
+ * Routes through three branches:
+ * - `TtctlError` subclasses → uniform Error/Recovery/Code blocks
+ * - `profile.basic.ProfileError` → `(<CODE>): <message>` line
+ * - anything else → generic `text: <message>`
+ *
+ * `commandLabel` (e.g. `"profile.education.add"`) prefixes the error
+ * line for sub-domain disambiguation.
+ */
+export function presentToolError(commandLabel, err) {
+    if (err instanceof TtctlError)
+        return ttctlErrorToToolResponse(err);
+    if (err instanceof profile.basic.ProfileError) {
+        return {
+            isError: true,
+            content: [{ type: "text", text: `${commandLabel} failed (${err.code}): ${err.message}` }],
+        };
+    }
+    if (err instanceof DateInputError) {
+        return {
+            isError: true,
+            content: [{ type: "text", text: `${commandLabel} failed (${err.code}): ${err.message}` }],
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        isError: true,
+        content: [{ type: "text", text: `${commandLabel} failed: ${message}` }],
+    };
+}
+export function createTokenResolver(configPath) {
+    return async function resolveTokenForTool(commandLabel) {
+        let token;
+        try {
+            const { config } = resolveConfig({ path: configPath });
+            token = config.auth.token;
+        }
+        catch (err) {
+            if (err instanceof ConfigError) {
+                emitMcpAuthResolve(configPath, "config_error", false);
+                return {
+                    error: {
+                        isError: true,
+                        content: [{ type: "text", text: `${commandLabel} failed (${err.code}): ${err.message}` }],
+                    },
+                };
+            }
+            throw err;
+        }
+        if (token === undefined) {
+            emitMcpAuthResolve(configPath, "unauthenticated", false);
+            return {
+                error: {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: `${commandLabel} failed (UNAUTHENTICATED): No auth token found. Run \`ttctl auth signin\` to sign in.`,
+                        },
+                    ],
+                },
+            };
+        }
+        emitMcpAuthResolve(configPath, "ok", true);
+        return Promise.resolve({ token });
+    };
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/profile/shared.js.map

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

package/dist/tools/profile/visas.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "../_shared.js";
+/**
+ * Register the four `ttctl_profile_visas_*` MCP tools.
+ *
+ * Tool names use the canonical sub-domain `visas` (no CLI alias). Each
+ * tool maps 1:1 to a CLI leaf. Dry-run path (issue #165): every tool
+ * accepts `dryRun?: boolean` and emits the uniform `{ ok, dryRun, preview }`
+ * envelope via MCP-level preview building when `dryRun: true`.
+ * `variables.input.profileId` (list) carries
+ * `DRY_RUN_PROFILE_ID_PLACEHOLDER` because the apply path resolves it
+ * via a sibling profile read.
+ */
+export declare function registerVisasTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=visas.d.ts.map

package/dist/tools/profile/visas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visas.d.ts","sourceRoot":"","sources":["../../../src/tools/profile/visas.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AASpG;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAyIxF"}

package/dist/tools/profile/visas.js

@@ -0,0 +1,170 @@
+// 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, dryRunResponse } from "../_shared.js";
+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 four `ttctl_profile_visas_*` MCP tools.
+ *
+ * Tool names use the canonical sub-domain `visas` (no CLI alias). Each
+ * tool maps 1:1 to a CLI leaf. Dry-run path (issue #165): every tool
+ * accepts `dryRun?: boolean` and emits the uniform `{ ok, dryRun, preview }`
+ * envelope via MCP-level preview building when `dryRun: true`.
+ * `variables.input.profileId` (list) carries
+ * `DRY_RUN_PROFILE_ID_PLACEHOLDER` because the apply path resolves it
+ * via a sibling profile read.
+ */
+export function registerVisasTools(server, ctx) {
+    server.registerTool("ttctl_profile_visas_list", {
+        title: "List travel visas",
+        description: "List the signed-in user's travel-visa records (id, country, type, expiry). Pass `dryRun: true` to preview the request.",
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("getTravelVisas", "mobile-gateway", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const visas = await profile.visas.list(auth.token);
+            return successResponse(visas);
+        }
+        catch (err) {
+            return mapVisasError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_visas_add", {
+        title: "Create a travel-visa record",
+        description: "Create a new travel-visa record. Both `countryId` and `visaType` are required; `expiryDate` is optional. Pass `dryRun: true` to preview the request.",
+        inputSchema: {
+            countryId: z.string().describe("Country id (server-issued; query the Toptal travel-visa form for valid ids)"),
+            visaType: z.string().describe("Visa type (e.g., Schengen, B1/B2, Tier 5)"),
+            expiryDate: z.string().optional().describe("Expiry date in YYYY-MM-DD"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        const input = {
+            countryId: args.countryId,
+            visaType: args.visaType,
+        };
+        if (args.expiryDate !== undefined)
+            input.expiryDate = args.expiryDate;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("createTravelVisa", "talent-profile", { input: { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER, travelVisa: input } }, auth.token));
+        }
+        try {
+            const visas = await profile.visas.add(auth.token, input);
+            return successResponse(visas);
+        }
+        catch (err) {
+            return mapVisasError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_visas_update", {
+        title: "Update a travel-visa record",
+        description: "Update fields on a travel-visa record by id. Only supplied fields are updated. Pass `dryRun: true` to preview the request.",
+        inputSchema: {
+            id: z.string().describe("Id of the travel-visa record"),
+            countryId: z.string().optional().describe("Country id"),
+            visaType: z.string().optional().describe("Visa type"),
+            expiryDate: z.string().optional().describe("Expiry date in YYYY-MM-DD"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        const changes = {};
+        if (args.countryId !== undefined)
+            changes.countryId = args.countryId;
+        if (args.visaType !== undefined)
+            changes.visaType = args.visaType;
+        if (args.expiryDate !== undefined)
+            changes.expiryDate = args.expiryDate;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("updateTravelVisa", "talent-profile", { input: { travelVisaId: args.id, travelVisa: changes } }, auth.token));
+        }
+        try {
+            const visas = await profile.visas.update(auth.token, args.id, changes);
+            return successResponse(visas);
+        }
+        catch (err) {
+            return mapVisasError(err);
+        }
+    });
+    server.registerTool("ttctl_profile_visas_remove", {
+        title: "Remove a travel-visa record",
+        description: "Remove a travel-visa record by id. Pass `dryRun: true` to preview the request.",
+        inputSchema: {
+            id: z.string().describe("Id of the travel-visa record to remove"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("removeTravelVisa", "talent-profile", { input: { travelVisaId: args.id } }, auth.token));
+        }
+        try {
+            const visas = await profile.visas.remove(auth.token, args.id);
+            return successResponse(visas);
+        }
+        catch (err) {
+            return mapVisasError(err);
+        }
+    });
+}
+function successResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function mapVisasError(err) {
+    const typed = ttctlErrorToToolResponseOrNull(err);
+    if (typed !== null)
+        return typed;
+    if (err instanceof profile.visas.VisasError) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `Error: ${err.message}`,
+                        "",
+                        "Recovery: Adjust the tool input or retry; see the code below.",
+                        "",
+                        `(Code: ${err.code})`,
+                    ].join("\n"),
+                },
+            ],
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: [
+                    `Error: travel-visa request failed: ${message}`,
+                    "",
+                    "Recovery: Retry; if the failure persists, file an issue.",
+                    "",
+                    "(Code: UNKNOWN)",
+                ].join("\n"),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=visas.js.map

package/dist/tools/profile/visas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visas.js","sourceRoot":"","sources":["../../../src/tools/profile/visas.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAgC,MAAM,eAAe,CAAC;AAEpG,MAAM,aAAa,GAAG,CAAC;KACpB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,+JAA+J,CAChK,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,GAA4B;IAChF,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,wHAAwH;QAC1H,WAAW,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;KACvC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACnC,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,cAAc,CACnB,qBAAqB,CACnB,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAC3D,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnD,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,sJAAsJ;QACxJ,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;YAC7G,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YACvE,MAAM,EAAE,aAAa;SACtB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACnC,MAAM,KAAK,GAAkC;YAC3C,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;QACF,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACtE,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,cAAc,CACnB,qBAAqB,CACnB,kBAAkB,EAClB,gBAAgB,EAChB,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EACzF,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACzD,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,4HAA4H;QAC9H,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YACvD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;YACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;YACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YACvE,MAAM,EAAE,aAAa;SACtB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACnC,MAAM,OAAO,GAAkC,EAAE,CAAC;QAClD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACrE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAClE,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACxE,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,cAAc,CACnB,qBAAqB,CACnB,kBAAkB,EAClB,gBAAgB,EAChB,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EACzD,IAAI,CAAC,KAAK,CACX,CACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YACvE,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YACjE,MAAM,EAAE,aAAa;SACtB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACnC,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,cAAc,CACnB,qBAAqB,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAC9G,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9D,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAOD,SAAS,eAAe,CAAC,IAAa;IACpC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAAY;IACjC,MAAM,KAAK,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,GAAG,YAAY,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,UAAU,GAAG,CAAC,OAAO,EAAE;wBACvB,EAAE;wBACF,+DAA+D;wBAC/D,EAAE;wBACF,UAAU,GAAG,CAAC,IAAI,GAAG;qBACtB,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE;oBACJ,sCAAsC,OAAO,EAAE;oBAC/C,EAAE;oBACF,0DAA0D;oBAC1D,EAAE;oBACF,iBAAiB;iBAClB,CAAC,IAAI,CAAC,IAAI,CAAC;aACb;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/profile_basic_photo_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_basic_photo_show` MCP tool. Read-only.
+ *
+ * Dry-run path (issue #165): when `dryRun: true`, returns a preview of
+ * the `GET_PHOTO` query (talent-profile surface) that WOULD have been
+ * sent. The `profileId` variable carries `DRY_RUN_PROFILE_ID_PLACEHOLDER`
+ * because the apply path resolves it via a sibling `show()` call at
+ * execution time — the dry-run path skips that read entirely so no
+ * transport is invoked.
+ */
+export declare function registerProfileBasicPhotoShowTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_basic_photo_show.d.ts.map

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

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

package/dist/tools/profile_basic_photo_show.js

@@ -0,0 +1,59 @@
+// 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_photo_show";
+/**
+ * Register the `ttctl_profile_basic_photo_show` MCP tool. Read-only.
+ *
+ * Dry-run path (issue #165): when `dryRun: true`, returns a preview of
+ * the `GET_PHOTO` query (talent-profile surface) that WOULD have been
+ * sent. The `profileId` variable carries `DRY_RUN_PROFILE_ID_PLACEHOLDER`
+ * because the apply path resolves it via a sibling `show()` call at
+ * execution time — the dry-run path skips that read entirely so no
+ * transport is invoked.
+ */
+export function registerProfileBasicPhotoShowTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Show profile photo URLs",
+        description: [
+            "Fetch the URLs of the signed-in user's profile photo (default / original / small variants plus the recommended crop rectangle and a `isResolutionSatisfied` flag).",
+            "",
+            "Pass `dryRun: true` to preview the request without firing the query.",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Show me my Toptal profile photo."',
+            '  - "What are the URLs of my profile photo variants?"',
+            '  - "Is my profile photo resolution OK?"',
+        ].join("\n"),
+        inputSchema: {
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe("Preview the request without executing. Returns `{ ok: true, dryRun: true, preview }` with the GET_PHOTO operation; `variables.profileId` is a placeholder that the apply path would have resolved via a sibling profile read. Default: false."),
+        },
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        if (input.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("GET_PHOTO", "talent-profile", { profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER }, auth.token));
+        }
+        try {
+            const payload = await profile.basic.photoShow(auth.token);
+            return jsonResponse(payload);
+        }
+        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_photo_show.js.map

package/dist/tools/profile_basic_photo_show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile_basic_photo_show.js","sourceRoot":"","sources":["../../src/tools/profile_basic_photo_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,gCAAgC,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAAiB,EAAE,GAA4B;IAC/F,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE;YACX,oKAAoK;YACpK,EAAE;YACF,sEAAsE;YACtE,EAAE;YACF,oDAAoD;YACpD,wCAAwC;YACxC,uDAAuD;YACvD,0CAA0C;SAC3C,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,+OAA+O,CAChP;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,CACnB,qBAAqB,CACnB,WAAW,EACX,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,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1D,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;QAC/B,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_basic_photo_upload.d.ts

@@ -0,0 +1,24 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_profile_basic_photo_upload` MCP tool. Mirrors the
+ * `ttctl profile basic photo upload <file>` CLI leaf — uploads a new
+ * profile photo from a local file path.
+ *
+ * The tool accepts only a `file` path (string). Buffer input from the CLI
+ * surface is not exposed here because MCP transports are JSON-only —
+ * passing binary through MCP would require base64 wrapping that's brittle
+ * and confusing for LLM clients. Use the CLI leaf if you need to upload
+ * a buffer programmatically.
+ *
+ * Dry-run path (issue #165): when `dryRun: true`, returns a preview of
+ * the `UploadProfilePhoto` mutation's GraphQL operations envelope (the
+ * top-level fields of the multipart form's `operations` part). The
+ * multipart binary payload itself is NOT described — only the GraphQL
+ * request shape that would be sent in the `operations` part of the
+ * multipart envelope. `variables.input.profileId` is the placeholder
+ * `DRY_RUN_PROFILE_ID_PLACEHOLDER` (apply path resolves it via a
+ * sibling profile read).
+ */
+export declare function registerProfileBasicPhotoUploadTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_basic_photo_upload.d.ts.map

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

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

package/dist/tools/profile_basic_photo_upload.js

@@ -0,0 +1,90 @@
+// 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";
+import { UPLOAD_CATEGORIES, validateUploadPath } from "./file-upload.js";
+import { profileBasicPhotoUploadOutputSchema } from "./output-schemas.js";
+const TOOL_NAME = "ttctl_profile_basic_photo_upload";
+/**
+ * Register the `ttctl_profile_basic_photo_upload` MCP tool. Mirrors the
+ * `ttctl profile basic photo upload <file>` CLI leaf — uploads a new
+ * profile photo from a local file path.
+ *
+ * The tool accepts only a `file` path (string). Buffer input from the CLI
+ * surface is not exposed here because MCP transports are JSON-only —
+ * passing binary through MCP would require base64 wrapping that's brittle
+ * and confusing for LLM clients. Use the CLI leaf if you need to upload
+ * a buffer programmatically.
+ *
+ * Dry-run path (issue #165): when `dryRun: true`, returns a preview of
+ * the `UploadProfilePhoto` mutation's GraphQL operations envelope (the
+ * top-level fields of the multipart form's `operations` part). The
+ * multipart binary payload itself is NOT described — only the GraphQL
+ * request shape that would be sent in the `operations` part of the
+ * multipart envelope. `variables.input.profileId` is the placeholder
+ * `DRY_RUN_PROFILE_ID_PLACEHOLDER` (apply path resolves it via a
+ * sibling profile read).
+ */
+export function registerProfileBasicPhotoUploadTool(server, ctx) {
+    server.registerTool(TOOL_NAME, {
+        title: "Upload profile photo",
+        description: [
+            "Upload a new profile photo from a local image file (jpg / png / gif / webp). Image content-type is inferred from the file extension.",
+            "",
+            "Pass `dryRun: true` to preview the request without firing the mutation. The preview describes the GraphQL `operations` envelope only (not the multipart binary body).",
+            "",
+            "Example user prompts that should map to this tool:",
+            '  - "Upload /Users/me/Pictures/headshot.jpg as my Toptal profile photo."',
+            '  - "Set my profile photo to ./avatar.png."',
+        ].join("\n"),
+        inputSchema: {
+            file: z
+                .string()
+                .min(1)
+                .describe("Absolute or relative path to the image file to upload. Must be readable by the MCP server process."),
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe("Preview the request without executing. Returns `{ ok: true, dryRun: true, preview }` for the UploadProfilePhoto operation; the multipart binary body is NOT enumerated (only the GraphQL operations envelope). Default: false."),
+        },
+        outputSchema: profileBasicPhotoUploadOutputSchema.shape,
+    }, async (input) => {
+        const auth = await ctx.loadTokenForTool(TOOL_NAME);
+        if (isToolErrorResponse(auth))
+            return auth;
+        if (input.dryRun === true) {
+            // The multipart envelope's `operations` part carries:
+            //   { operationName, query, variables: { input: <UpdatePhotoInput, file=null> } }
+            // — the actual file lives in a separate multipart part referenced
+            // via the `map` field. The dry-run preview describes the operations
+            // envelope only (mirroring the wire shape that `photoUpload` builds
+            // in core/services/profile/basic/index.ts).
+            return dryRunResponse(buildMcpDryRunPreview("UploadProfilePhoto", "talent-profile", {
+                input: {
+                    profileId: profile.basic.DRY_RUN_PROFILE_ID_PLACEHOLDER,
+                    photo: null,
+                    transformation: { cropped: { x: 0, y: 0, width: 0, height: 0 } },
+                },
+            }, auth.token));
+        }
+        const pathError = validateUploadPath(input.file, UPLOAD_CATEGORIES.basicPhoto);
+        if (pathError !== null)
+            return pathError;
+        try {
+            const result = await profile.basic.photoUpload(auth.token, { file: input.file });
+            return jsonResponse(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_photo_upload.js.map

package/dist/tools/profile_basic_photo_upload.js.map

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

package/dist/tools/profile_basic_show.d.ts

@@ -0,0 +1,64 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { profile } from "@ttctl/core";
+import type { ProfileShowQuery } from "@ttctl/core";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Merged payload returned by `ttctl_profile_basic_show`. Mirrors the
+ * CLI's `BasicShowPayload` shape (`packages/cli/src/commands/profile/
+ * basic/show.ts`) so the read surface speaks the same vocabulary across
+ * MCP and CLI clients.
+ *
+ * `profile` carries the mobile-gateway `ProfileShowQuery` (identity, role,
+ * vertical, skills, hours, rate); `basicInfo` carries the talent-profile
+ * `BasicInfo` projection (`bio`, `headline`, `languages`). The two come
+ * from different GraphQL surfaces — the mobile-gateway `Profile` type does
+ * NOT publish `about` / `quote`, hence the dedicated `getBasicInfo()`
+ * companion shipped in #127.
+ *
+ * `basicInfo` is `null` when the secondary `getBasicInfo()` call failed in
+ * a non-session-level way (network blip, talent-profile `GRAPHQL_ERROR`).
+ * Session-level failures (`AuthRevokedError`, `Cf403Error`) propagate as
+ * tool errors — they indicate the bearer is no longer accepted, and the
+ * primary `show()` call would have hit them too.
+ */
+export interface BasicShowPayload {
+    profile: ProfileShowQuery;
+    basicInfo: profile.basic.BasicInfo | null;
+}
+/**
+ * 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 declare function registerProfileBasicShowTool(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=profile_basic_show.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile_basic_show.d.ts","sourceRoot":"","sources":["../../src/tools/profile_basic_show.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD,OAAO,EAOL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AAItB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAqElG"}